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INTRODUCTION 


SECTION 


ABOUT THIS MANUAL 


The HP 150 Programmer's Reference Manual is intended for the advanced programmer 
who is developing assembly-level application programs for the HP 150 system. 

This manual assumes that you are familiar with high-level language programming 
and also with low-level Intel 8086/8088 assembly language programming. Because 
many of the procedures in this manual require assembly language programming and 
issuance of MS-DOS system function calls, the following documents are included 
with the manual: 

o MicrosoftTM Series 100/MS-DOS ® User’s Guide 
o Microsoft Series 100/MS-DCS Macro Assembler Manual 
o Microsoft Series 100/MS-DOS Programmer’s Reference Manual 
o IntelTM iAPX 88 Book 

The 3.5” disc that comes with this manual contains the following utilities: 

Macro Assembler (MASM.EXE) 

Linker (LINK.EXE) 

Cross-Reference (CREF.EXE) 

Library (LIB.EXE) 

Line Editor (EDLIN.COM) 

Debugger (DEBUG.COM) 

Find (FIND.EXE) 

File Compare (FC.EXE) 

Sort (SORT.EXE) 

File Conversion (EXE2BIN.EXE) 


SUPPORT 


Because of the specialized nature of this product and the many capabilities of 
the HP 150 when programmed at this level, assistance on using this product is 
provided only through consultation. Contact your local HP Sales and Service 
Office -- ask for Personal Computer Systems Engineering. Consulting is 
available by the hour (Product No. U 5686 A) or by th<* day (Product No. U 5687 A). 
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COMPATIBILITY 


A hardware/software product designed to be dependent on one specific version of 
the HP 150 hardware, firmware, or software may be incompatible with other 
versions of the HP 150 --or such a product may be incompatible with future 
personal computer products from Hewlett-Packard, including models based on the 
HP 150 itself. 


ABOUT THE HP 150 


The HP 150 supports two modes of operation: Terminal mode or Computer mode. It 
can function as a stand-alone personal computer and also as a full-function 
intelligent terminal. 

Because the HP 150 is both a personal computer and an intelligent terminal, you 
can control the display and the keyboard in two ways: 

1 . via escape sequence programming, and 

2. via Alphanumeric/Graphics Input/Output Subsystem (AGIOS) 
function calls. 

This manual contains detailed information on developing applications using 
either escape sequences or AGIOS functions. 

The HP 150 also provides an extended set of control functions for data 
communications, as well as the standard I/O functions of the MS-DOS operating 
system. This manual describes the extended data comm functions in detail, and 
explains how to use them to develop individual data comm programs. 


Escape Sequence Programming 

You earn use escape sequences in standard console output statements in any 
programming language. When you send an escape character (ASCII code 27 
decimal), the HP 150 terminal interprets the next one or more characters as 
special control codes, instead of as characters to be displayed on the screen. 

However, the terminal’s escape-sequence processor is relatively slow. Standard 
console output occurs at a rate of approximately 700 characters a second. If 
this speed is acceptable for your application, you will probably want to program 
with escape sequences. 
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AGIOS Function Calls 

The second way to control the display and the keyboard is to use AGIOS function 
calls. The AGIOS, which is a unique feature of the HP 150, lets you write 
high-speed applications without using specific hardware information. Virtually 
all of the tasks that commonly require Basic I/O System (BIOS) calls can be done 
easily using AGIOS. 

With AGIOS, your application need not depend on specific hardware addresses, 
revisions of computer firmware, or the Operating System BIOS. 

In order to use AGIOS functions, your application must include special set-up 
conditions. For example, your applications must build an input buffer for the 
desired function code and any additional parameters. The desired function is 
executed via a software interrupt that is sent to the MS-DOS operating system. 

The AGIOS function calls let you write high-speed output routines and gain total 
control over the HP 150 display and keyboard. AGIOS lets console output occur 
at rates up to U000 characters per second. 

AGIOS also gives you access to capabilities that are not accessible through 
escape sequences. These capabilities include intercepting keyboard keys, 
interpreting application softkeys, displaying a block of data on the screen, and 
creating user-defined graphics characters. 

Thus, the use of escape sequence programming together with AGIOS function calls 
gives you a great deal of flexibility in developing application programs. If 
the desired operation is available via an escape sequence, and performance speed 
is not an issue, you may well prefer to use escape sequences. On the other 
hand, if your application requires faster console output, or if the function you 
want to use does not have an equivalent escape sequence, AGIOS is the preferred 
method. You can use escape seqeunces or AGIOS functions interchangeably 
depending on the nature of your application. 
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MANUAL OVERVIEW 


This manual consists of the following sections and appendices: 

Section 1 : Introduction 

An overview of the material presented in this manual. 

Section 2 : Escape Sequence Programming 

Programming with the escape sequences that are available in the HP 150. 

Section 3 : Alphanumeric/Graphics Input/Output Subsystem 

Programming with Alphanumeric/Graphics Input/Output Subsystem (AGIOS) function 
calls. This section also includes the syntax used in the function reference in 
Sections U and 5 . 

Section U : Alphanumeric Input/Output Subsystem Function Reference 

Describes the Alphanumeric Input/Output Subsystem (AIOS) function calls. For 
each AIOS function, there is a detailed description of input parameters, output 
status, and additional remarks. For a few selected functions, an example is 
included to illustrate a possible use of the function. 

Section 5 : Graphics Input/Output Subsystem Function Reference 

Describes the Graphics Input/Output Subsystem (GIOS) function calls. For each 
GIOS function, there is a detailed description of input parameters, output 
status, and additional remarks. For a few selected functions, an example is 
included to illustrate a possible use for the function. 

Section 6 : Data Communications 

Writing data communications applications using standard MS-DOS Input/Output 
functions and Hewlett-Packard extended data communications functions. For each 
HP extended data communications function, there is a detailed description of 
input parameters, output status, and additional remarks. For some functions, an 
example is included to illustrate a possible use for the function. 
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Appendix A: AGIOS Functions and Escape Sequences Quick Reference 

Lists all the AGIOS functions and the equivalent escape sequences, if available. 

Appendix B: Calling AGIOS Functions from High-Level Languages 

Information on calling AGIOS functions from high-level languages. The languages 
discussed in this appendix are Pascal and BASIC. The same principles apply to 
other languages. 

Appendix C : Examples of AGIOS Functions 
A Pascal-callable example of each video intrinsic in AIOS. 

Appendix D : Graphics Control Functions 

Information on the terminal’s graphics functions and how they are used. The 
information and examples are intended for use in developing programs to control 
the graphics functions. 















SECTION 


ESCAPE SEQUENCE PROGRAMMING 


r 


INTRODUCTION 



THT - EL 


J 


Escape Sequences provide a way to control the HP 150 keyboard and display via a 
program. A program sends an escape sequence to the terminal by printing the 
sequence to the console device. For example, the following BASIC statement 
tells the terminal to issue an ’ESC J’ sequence to clear the display: 

PRINT CHR$( 27 ); "J" 

When the HP 150 receives an escape sequence from an executing program, it 

been°«tereH TT™ specif i ed in the just as if the sequence had 

“ t * r * d by l he operator from The keyboard in Terminal mode. The operations 
performed range from controlling the appearance of the display screen (such as 
displaying text full-bright or half-bright) to redefining a function key that is 
to be used by an application program you are writing. 

Rentes consist of two characters; others consist of more than two 
characters. Two-character and multiple-character escape sequences perform 
different types of functions; and the rules for entering them are also 
different. 

Two-character escape sequences generally correspond to functions performed by a 
1 1 ^f le ^. keyStr0ke at the ke y board - F <>r example, the horizontal TAB key at the 
left of your terminal keyboard corresponds to the two-character escape sequence 

ESC I 

which performs a TAB ("forward tab"). In two-character escape sequences, you 
must specify the escape code characters exactly. The following sequence 

ESC i 

using the lower-case parameter "i" performs a BACKTAB. In general, upper-case 
and lower-case parameters in two-character escape sequences have very different 
meanings to the system. y 

Multiple-character escape sequences generally refer to functions that require 
one or more parameters. Usually, the order of the parameters is not important. 
The first three characters of a multiple-character escape sequence define the 
type of function to be performed. Positioning the cursor to a particular column 
? W posl * lon on the screen requires a multiple-character escape sequence 
(ESC & a). For example, the sequence 
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ESC & a 5 c 10 R 

places the cursor at the sixth column of the eleventh row on the terminal 
screen. In this case, however, the sequence 

ESC & a 10 r 5 C 

performs exactly the same function. Although the order of the parameters in an 
escape sequence is not important, the case of the parameters is significant. 

Because the number of characters in a given sequence depends upon the number of 
parameters, and because several parameters can be combined in one escape 
sequence, the terminal needs to know where a sequence ends. For this reason, 
the last parameter in a multiple-character escape sequence must be an upper-case 
letter , and all preceding parameters must be lower-case. The first upper-case letter 
following the ESC character ends the sequence. 

You can combine multiple-character escape sequences of the same type in a single 
sequence. For example, if you want to change the values of the Local Echo and 
Caps Lock parameters in your Terminal Configuration menu, you can change 
individual values using the following sequences: 


Value: 

Escape Sequence: 

Local Echo = NO 

ESC 

8c k 0 L 

Local Echo = YES 

ESC 

8c k 1 L 

Caps Lock = NO 

ESC 

8c k 0 C 

Caps Lock = YES 

ESC 

8c k 1 C 

To change both values, 

or to 

change any parameters in the ESC 

could use one sequence 

For 

example, to set Local Echo = No 

Yes, you could use either of 

the following sequences: 

ESC & k 0 1 1 C 



or 



ESC 8c k 1 c 0 L 




The final identifier must be an upper-case letter, and the preceeding 
identifiers must be lower-case letters. 


NOTE 


In these and other examples, the elements of the escape 
sequences are separated by spaces. However, when you 
enter escape sequences at the terminal or print them 
from a program, all characters must be contiguous, as 
indicated below: 

ESC&aSclOR 
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Parameters for escape sequences are enclosed in angle 
brackets (<>). Lastly, throughout this manual, ’ESC* 
and ’Ec’ indicate the Escape Key. 
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This section gives details and examples for escape sequence programming that 
will help you use the major features of the HP 150. The following topics appear 
in this section: 

o User-Definable Softkeys 
o Touchscreen Programming 
o Keyboard Control 

o Character Enhancements and Screen Control 
o Mode Selections 

o Block Transfers 

o Data Operations 

o Status Requests 

In addition. Appendix D gives details and examples on Graphics Control 
Functions. 

You will also find a summary of escape sequences in the HP 150 Terminal User's 
Guide which was included with your system. 
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INTRODUCTION TO SOFTKEYS 


There are three sets of function keys on the HP 150: System Keys, User-Defined 
Keys, and Application Keys. You gain access to the system function keys through 
the [User System] key. These keys are maintained by the system. The other two 
sets of function keys cam be programmed by your application. The first set is 
the "User-Definable Softkeys," which are programmed via escape sequences. The 
other set is the "Application Softkeys", which are controlled via AGIOS calls. 
(The section on AGIOS Programming contains more information about these calls.) 
These two sets of softkeys are summarized below. 


User-Definable Softkeys 

o Are the set of 8 keys labeled [fl] through [f8] on the keyboard. 

o Are defined and displayed under program control by means of escape 

sequences. 

o Can also be displayed by pressing [CTRL] [User System] keys. 

o Can be programmed to perform terminal functions alone, or to simulate 
keyboard input with or without an automatic carriage return. 

o Can contain up to 80 characters in each key definition. 

o Cam contain up to l6 characters on two lines in each key label, or can use 

the default label (e.g., [fl]). 


Application Softkeys 

o Are the set of 8 keys labeled [fl] through [f8], together with the 4 
unlabeled keys at the top of the numeric keypad on the keyboard. 

o Are defined, displayed, and controlled by AGIOS function calls. 

o Can also be displayed by pressing [Shift] [User System] keys. 

o Are normally used for input only in Keycode mode. The section on Keycode 
mode contains more information. 

o Return a keycode for each key, to be interpreted and processed by your 
application program. 

For more information on Application Softkeys, refer to the section on 

Application Softkeys* 
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Defining the User Softkeys 

The escape sequence that you use to program the User-Definable softkeys has the 
following general format: 

ESC & f <attr> a <key> k <enh> v <lab half> x <lab len> d <buf len> L 
<lab> <buf> 


As is true for all multi-character escape sequences, the HP 150 processes this 
sequence until the first upper-case character occurs. The characters in the 
above escape sequence are defined in the following way: 

ESC The escape character (ASCII 27 decimal). 

& f The "define function key" sequence. 

<attr> a The attribute. Values for <attr> are: 

0 = Normal Key 

1 = Local Key 

2 = Transmit Key 

(See the note on the next page.) 

<key> k The softkey number. <key> must be in the range 

from 1 to 8, inclusive. 


<enh> v The enhancement for the label. Values for <enh> are: 

0 None 

1 Blinking 

2 Inverse video 

3 Blinking and inverse video 

4 Underline 

5 Blinking and underline 

6 Inverse video and underline 

7 Blinking, inverse video, and underline 

8 Half-bright 

9 Blinking and half-bright 

10 Inverse video and half-bright 

11 Blinking, inverse video, and half-bright 

12 Underline and half-bright 

13 Blinking, underline, and half-bright 

14 Inverse video, underline, and half-bright 

15 Blinking, inverse video, underline, and half-bright 


<lab half> x The portion of the label to be enhanced. Values 
for <lab half> are: 


1 Top half of label 

9 Bottom half of label 
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<lab len> d The length of the softkey label; <lab len> must be between 0 and 

80. However, only the first 16 characters will be used. 

<buf len> L The length of the response buffer; <buf> must be between -1 and 

80. A length of -1 clears the <buf>. 

Notice that the character that follows <buf len> is an uppercase 
"L". This character ends the escape sequence. The <lab> and 
<buf> parameters that follow it are treated as data when the 
escape sequence is executed. 

If you do not want to change the <buf len> parameter, make sure 
that the last parameter specified is an upper-case letter. 


<lab> 


The ASCII characters to be displayed in the on-screen softkey 
labels. 


<buf> The ASCII characters associated with the softkey. 

For example, the following escape sequence defines the user-defined function key 
number 2 to be a Transmit key, softkey label is "Log on", softkey definition is 
"Hello manager.user", and use default settings for the other parameters: 

ESC fc f 2 k 2 a 6 d 16 LLog onHello Eunice.Yan 
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| NOTE 


Local defined keys execute only in the HP 150 display. None of 
the characters in <buf> are sent to the user program. Local 
keys generally are not useful in applications. 

For Normal and Transmit keys, characters in <buf> are sent to 
standard console input. The principal difference is that in 
Transmit keys, a carriage return is appended to the end of each 
softkey buffer (hence transmitted to the internal computer). 

The characters in a Normal key buffer are sent to the program, 
but no carriage return is automatically appended. In order for 
your application to receive the characters, it has to use the 
correct handshaking. The section on Block Transfers has 
additional information on using handshake. 

In BASIC, for example, the INPUT statement requires a carriage 
return to end input. If you are using the INPUT statement, be 
sure to define keys with the Transmit attribute. 

However, the INPUT$ function does not require a carriage 
return. If you are using this instruction for input, you can 
use Normal keys. 

The sum of <lab len> and <buf len> must be less than 160 
characters. 
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Displaying the User-Defined Softkeys 

Once you define one (or more) of the User-Defined Softkeys, you will probably 
want to display them. To do so, use the following general escape sequence 
format, with the appropriate <parm> value: 

ESC & j <parm> 

The <parm> options and their meaning are listed below: 

g: This option turns off the labels currently displayed on the screen and 
the row and column indicators. It also turns off the Status Line, 
including the time and other status information. 

A: This option displays the Modes System Key labels on the screen. This is 
the level a user would see by pressing [User System] [fU] keys. 

B: This option displays the currently defined set of User-Defined Softkey 
labels. If no labels have been defined, the default labels [fl] through 
[f8] are used. This is the programmatic equivalent of presing 
[CTRL][User System] keys. 

S: This options disables the [Menu] and [User System] keys, and locks the 
current softkey selections. Keys [fl] through [f8] can still be used. 

R: This option enables the [Menu] and [User System] keys. 

When using the User-Defined Softkeys, you should keep in mind the following 
facts: 

o First, the User-Defined Softkeys remain "alive" even when the labels are 
not displayed. That is, when the User-Defined Softkeys are displayed using 
the ESC jt j B sequence, and then turned off with the ESC & j @ sequence, 
the screen labels are still active and will return the softkey definition 
when touched or pressed. 

o Second, when you use the ESC & j sequence, the changed labels and 

definition string are not updated until you redisplay the labels by means 
of an ESC & j B sequence. 

o Finally, if Keycode mode is enabled, your application receives four bytes 
of input for each character in the <buf> field! See Keycode Mode in 
Section U for more information. 
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Displaying a User-Defined Message 

There is one more valid parameter to the ESC !c j sequence which requires 
slightly different syntax. The syntax of this sequence is: 

ESC & j <len> L <message> 

This sequence lets an application display up to 160 characters (two lines) of 
text in place of the softkey labels on rows 25 and 26 on your screen. The 
message is displayed on the screen until the [Return] key is pressed, and cannot 
be locked on the screen. The <len> parameter, which must be between 0 and 160 
inclusive, specifies the number of bytes after the letter L that are to be 
displayed. The <message> buffer is displayed in place of the screen labeled 
softkeys. 


Executing the User-Defined Softkeys 

The following escape sequence executes the content currently assigned to the 
softkey specified in <x>: 

ESC & f <x> E 

X Key 


1 fl 

2 f2 

3 f3 

U th 

5 f5 

6 f6 

7 f7 

8 f8 
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Programming Considerations 

User-Defined Softkeys on the HP 150 are not interrupt-driven. This means that 
your application needs to check the keyboard buffer periodically for softkey 
presses. 

Sometimes you will want softkey input to be indistinguishable from keyboard 
input. For example, an application menu may prompt the user for a numbered 
selection. By defining the softkey contents so that the selection number 
corresponds to the key number, the user can either type the menu selection or 
press the appropriate softkey. This procedure lets the User-Defined Softkeys, 
labeled appropriately, augment other keyboard input. 

At other times, you may want softkey input to be unique. For example, an 
application may offer a user the ability to either type a filename or exit the 
program. If the user types any valid string, the application treats that input 
as a filename. If the ’exit* softkey is pressed, the application ends. 


One way to solve this dilemma is to define the softkeys with control characters. 
Although the user can enter a control character from the console, your 
application can examine the character’s ASCII value to distinguish between a 
normal ASCII input and the control-code definition of the softkeys. 


To use this scheme successfully, you need to select softkey definitions that do 
not have unwanted effects on the operation of the system. ASCII values in the 
range from 18 through 25 do not interfere with system operation. Below this 
range, tab (8), line feed (10), carriage return (12), and DC1 (17) interfere. 
Above this range, the escape character (27) interferes. Given softkey 
definitions in the range from 18 through 25, here is a BASIC program segment 
that accepts keyboard input and sets a flag (KEY) to the softkey number when a 
softkey is pressed. 


3000 A$ = INPUT$(1) 

3010 A = ASC(A$) : KEY = 0 
3020 IF A<l8 OR A>25 THEN 30U0 
3030 KEY = A - 17 
30U0 REM Continue with program 


’Get character without echo 
’Get value; assume no KEY 
’Not in softkey range 
’Put KEY in range 1-8 
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USING TOUCHSCREEN 


One unique feature of the HP 150 is the touchscreen. The touchscreen can be 
programmed in a variety of ways, giving you flexiblity in designing your 
application. This section describes how to program the touchscreen and explains 
how you caui make the best use of it in your application. 

The first thing you need to know about programming the touchscreen is the 
"modes" of operation. The simplest auid most flexible mode of operation involves 
"fields". In this mode, you tell the HP 150 information about where you want to 
detect touches, and the system firmware does most of the work. 

As you will see, you can turn the touchscreen on and off without affecting the 
fields you have defined. You can select video enhancements for both "touched" 
atnd "untouched" fields, caul control the positioning of the cursor, and can also 
tell the system to ’beep’ when a field is touched. 

A more comprehensive solution, but one which requires more work by the 
application, involves "row" and column sensing". In this mode, you do not have 
to define any touch fields. The touchscreen passes absolute row and column 
addresses to your application. As with fields, you can turn sensing on and off, 
and can control cursor positioning and touch beeping. 


Specifying Reporting Modes 

The default mode for touchscreen reporting is OFF; that is, the HP 150 does not 
let your application know that the screen has been touched. Using the following 
escape sequence, you can enable, disable all touchscreen reports, and specify 
the form in which touches are reported. 

ESC - z <smode> n [<tmode> m] 

The meaning of each parameter is listed below: 

ESC The escape character, ASCII 27 decimal. 

- z The sequence for setting the touch-sensing mode. 

<smode> n This parameter specifies the screen mode. Use this sequence to 

determine what type of reporting to perform. Possible values for 
<smode> are: 

0 = Turn off all reporting. This parameter turns off reporting 
without deleting any fields. Softkeys remain touch active 
unless you explicitly disable them using the Changing Softkey 
Touch Sensitivity sequence described later. 

1 = Enable row/column reporting only. This parameter disables 
field reporting, if active, and enables row/column reporting 


2-11 




Escape Sequence Programming 


only. You will receive row/column reports even when a field 
area is touched. 

2 = Enable touch-field reporting only. The only reports you 

receive are from defined fields. 

3 = Enable row/column and touch-field reporting. Touch fields are 

reported as defined. Row/column reports are made from all 
other areas of the screen. 

4 = Toggle touchscreen ON/OFF. When the touchscreen is OFF, all 

touchscreen operations are disabled. This parameter also 
disables softkey fields. The start-up default value of this 
parameter is ON. 

<tmode> M This parameter specifies the touch mode for row/column reporting; 

it determines when the HP 150 "tells" your application that touch 
is sensed. It is not required for touch fields because the 
sensing mode is set in the field definition. Moreover, this 
parameter is required for row/column sensing. If used with touch 
fields, this mode should correspond to the mode specified in the 
define-field escape sequence. 

Valid parameters for <tmode> are: 

1 = Report on touch only. 

2 = Report on release only. 

3 = Report on touch and release. 

Defining a Touch Field 

If you choose to use field reporting, the following escape sequence lets you 
define a touch field on the screen. Note that the "/" character is the 
continuation line marker, it is not part of the sequence. 

ESC - z g <rows> r <cols> c <curs> p <beep> b / 

<off_enh> e <on_enh> f <attr> a <mode> m / 

<buf len> L <buf> 

The meaning and valid entries for each of these fields are listed below. 

ESC The escape character, ASCII 27 decimal. 

-zg The sequence that represents a touch field definition. 

<rows> r Specifies the beginning and ending rows for this touch field. The 
<rows> parameter is specified as: 

<Start-row>,<End-row> 

The valid ranges for Start-row and End-row are from 0 to 47 
inclusive. End-row must be greater than or equal to the Start-row. 
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<cols> c 


<curs> p 


<beep> b 


<off enh> 


<on enh> f 


Specifies the beginning and ending columns for this touch field. 

The <cols> parameter is specified as: 

<Start-col>,<End-col> 

The valid ranges for Start-col and End-col are from 0 to 79 
inclusive. End-col must be greater than or equal to the Start-col. 

This parameter specifies whether the alphanumeric cursor should be 
positioned at the upper left corner of the field when the field is 
touched. Possible values for <curs> are: 

0 = The cursor does not move to the field. 

1 = The cursor is positioned at the upper left corner of the field. 

If "p" is not specified, the cursor is not positioned on touch. 

The "b" parameter specifies whether the system should beep when the 
field is touched. Valid values for <beep> are listed below: 

0 = No sound occurs when the field is touched. 

1 = The system makes a beep when the field is touched. 

If "b" is not specified, no beeping occurs when the field is 
touched. 


This parameter specifies the enhancement (if any) which is 
displayed when the field is OFF (not touched). Possible values for 
<off_enh> are shown in the Touch Enhancement Table on this page. 

If ”e" is not specified, the default off-enhancement of 10 is used. 
This displays a half-bright inverse field. 

This specifies the enhancement displayed when the field is ON, or 
touched. The possible values for <on-enh> are shown in the Touch 
Enhancements Table on this page. 


If "f” is not specified, the default on-enhancement of 2 is used. 
This causes an inverse video enhancement in the field. 

Table 2-1. Touch Enhancements Table 


Security 0FF| OI 23 U 56789 
Security ON | 1 6 17 18 19 20 21 22 23 2U 25 

Half-bright j X X 

Underline j X X X X 

Inverse Video| XX XX 

Blinking | X X X X X 


10 11 12 13 14 15 
26 27 28 29 30 31 


X X X X X X 
X X X X 
XX XX 

XXX 


When security is ON, any data that is entered is not 
displayed. (Only the selected enhancement is displayed.) 
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<attr> a This parameter specifies the type of field to be defined. The 
possible values for <attr> are listed below: 

1 = ASCII field 

2 = Keycode field (not supported with escape sequence) 

3 = Toggle field 

4 = Normal field 

The next section entitled "Types of Touch Fields and Reporting" 
contains a full explanation of the types of fields. 

<mode> m This parameter specifies the sensing mode for this field. The 
valid values for <mode> are listed below: 


1 = Report on touch 

2 = Report on release 

3 = Report on touch and release 

This parameter determines when the HP 150 "tells" your application 
that touch is sensed. 

<buf len> L This parameter specifies the length of the response string 
associated with this field. 

<buf> This parameter specifies the response buffer associated with this 

field. Although the parameter <buf> can be 0 to 80 bytes long for 
ASCII fields, it must be two characters in length for Toggle and 
Normal fields. These two characters will be reported back to your 
application in lower-case even though they may be defined as 
upper-case characters. 


Types of Touch Fields and Reporting 

The HP 150 lets you define the following four types of touch fields: 

1 . ASCII FIELDS. These fields are very similar to user-definable softkeys in 

that a buffer of up to 80 characters can be associated with every field. In 
an ASCII field, each time touch is sensed, your application receives the 
designated buffer as standard console input. 

2. KEYCODE FIELDS. This type of field lets you specify a Qualifier word and a 

Data word. When this field is touched, the above two words are returned to 
your application. These fields require Keycode mode, and is done via 
assembly language programming. To define a keycode touch field, you need to 
use the AGIOS function (0,32). The subsection entitled "Touchscreen 
Functions" contains more information about this function. 

3. TOGGLE FIELDS. Toggle fields are "regions" for which ON and OFF states make 

sense. When the field is first touched it is toggled on. When the field is 
touched again, it is toggled off. The following escape sequence is returned 
to your application according to the sensing mode parameter you specified. 

ESC - z <buf> <type> Q 


2-14 





Escape Sequence Programming 


<Buf> is the two-character buffer specified when the toggle field is 
defined. You should note that the characters are always returned in lower 
case. This two-character buffer could be used to identify the touch field. 
The <type> parameter will returns the following values: 

1 * Toggle field turning on 

2 = Toggle field turning off 

4. NORMAL FIELDS. These fields are similar to ASCII fields, but you use only a 
two-character <buf> parameter, as you do with toggle fields. The characters 
are always returned in lower case. The following escape sequence is 
returned for normal fields:. 

ESC - z <buf> <type> Q 

The <buf> parameter is the two-character buffer specified when the field is 
defined. Valid return values for <type> are: 

5 = Normal field touch sensed 

6 = Normal field release sensed 

The main difference between Toggle Fields and Normal Fields is that Toggle 
Fields have two states, (ON and OFF). A Normal Field is ON only while it is 
actually being touched. 


Row/Column Reporting 

The alternative to touch field reporting is row/column reporting. When 
row/column reporting is in effect, the touch reports that you receive have the 
following format: 

ESC - z <row> x <col> y <type> Q 

The <row> and <col> parameters are the two-digit integers that specify the row 
and column positions of the touch. <row> is from 0 through 47 and <col> is from 
0 through 79* Possible values for <type> are: 

3 = Row/Column touch reporting 

4 = Row/Column release reporting 

When you use row/column reporting, you do not have to define any touch fields. 
The <tmode> parameter in the Specifying Reporting Mode escape sequence lets you 
specify the touch mode for row/column reporting. 
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Deleting Touch Fields 

You may want to delete all touch fields or remove one or more selected fields. 
For example, if several options are presented as touch fields, you may want to 
remove all of the fields and continue to another menu. Or else, you may want to 
invalidate only certain fields, by deleting the fields that you do not want to 
use. 

The following escape sequence lets you delete a touch field other than a softkey 
field. If no field is defined at the specified coordinates, no action is taken. 

ESC - z d <row> r <col> C 


NOTE 


Any coordinates within a defined touch field will delete 
the entire field. 


The second form of this escape sequence, given below, deletes all touch fields. 
You should use this sequence whenever your application moves from one menu of 
touch fields to another menu of touch fields. 

ESC - z D 

Whenever a touch field is defined, the touch-field information is stored in 
terminal memory. Therefore, deleting fields conserves terminal memory. 
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Changing Softkey Touch Sensitivity 

The User-Definable Softkeys are touch sensitive by default. (The section on 
User-Definable Softkeys explains how to define these keys.) If you want to 
change the touch-sensitive nature of the softkeys, use the following escape 
sequence: 

ESC - z <key> s <mode> K 
The parameters are listed below: 


ESC The escape character, ASCII 27 decimal. 

-z The sequence indicating touchscreen control. 

<key> s The softkey number. <key> can be from 1 through 8 
inclusive. 


<mode> K The key mode. Its values are: 

0 = Disable touch on <key> 

1 = Enable touch on <key> 


Resetting the Touchscreen 

The following escape sequence resets all touch fields. 

ESC - z J 

Resetting the touchscreen turns all fields to the OFF state. This action 
affects the field state, but does not affect touch-sensing or reporting. 
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Programming Considerations 


The touchscreen provides a very easy way to add unique features to your 
application. However, there are a few things to keep in mind when you are using 
the touchscreen. 

You probably want to select one type of field and stick with it. ASCII fields 
are probably the best, because it is easy to equate them with valid keyboard 
input. This way your user can specify input either through the keyboard or via 
the touchscreen. If you use another type of field, you will have to parse the 
escape sequence that is returned to your application in order to determine which 
touch field was affected (touched) and how it was affected. 

You should also keep touch field responses to a minimum number of bytes, for the 
following two reasons: 

1. Your application screens will experience a minimal interference from touch 


input. 


2. You conserve the limited terminal memory space. Every time you create a 
touch field, additional memory is allocated to store the field information. 
This happens even if a defined field already exists in the same location 
because touch fields can overlay each other. 

This second point leads to another point to remember. When you are finished 
with a touch field, delete it! Lastly, you should not re-define a field over 
and over in a loop. The following two program segments illustrate this point: 


PROGRAM A 


1000 PRINT HOMEUP$; 
1010 GOSUB 2000 


’Clear screen; position cursor at top 
’Define a touch field (actual 
’ field not critical) 

’Read one character from touchscreen 

’ or from keyboard 

’Go off on option 1 

’Not option 1, return for more 


1020 A$=INPUT$(1) 


1030 IF A$=”l" GOTO 1500 
10U0 GOTO 1010 


Now look at Program B: 


PROGRAM B 


1000 PRINT H0MEUP$; 
1010 GOSUB 2000 


’Clear screen; position cursor at top 
’Define a touch field (actual 
’ field not critical) 

’Read one character from touchscreen 

’ or from keyboard 

’Go off on option 1 

’Not option 1, return for more 


1020 A$=INPUT$(1) 


1030 IF A$="l" GOTO 1500 
1040 GOTO 1020 
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See the difference? Look at line lOto. In Program A, the touch field is 
defined each time a character is accepted. In Program B, the touch field is 
defined only once. Program A eventually uses up the available memory in the 
system. 

When you use touchscreen, the touch fields "auto-repeats", just as the keys on 
the keyboard do. To prevent this action from complicating your application, use 
the touch-sensing-mode (ESC - z <smode> N) escape sequence to control acceptance 
of input. For example, notice how the following program controls the 
touchscreen: 

PROGRAM C 

1000 PRINT HOMEUP$; 

1010 GOSUB 2000 
1015 PRINT CHR$(27);"-z2N"; 

1020 A$=INPUT$(1) 

1025 PRINT CHR$(27);"-z0N"; 

1030 IF A$="l" GOTO 1500 
10U0 GOTO 1015 

2000 PRINT CHR$(27);"-zgl,5rl,5clbla2mlLl; 

2005 RETURN 

Note lines 1015 and 1025- They turn on sensing just before input is expected, 
and turn off sensing immediately after input is received. 

Of course, at line 1500 in all of the above examples, you should delete the 
selected touch field to avoid inputting additional (unwanted) characters. ( One 
possible exception might be the case in which program control returns to line 
1020 .) 

If more than one field is defined over a particular area of the screen, the HP 
150 reports only the most recently defined buffer. This fact can prove useful, 
because sometimes you will want to know whether the user is touching the screen 
but is not touching a defined field. You can obtain this information by 
defining the entire screen as a field with no enhancements for ON or OFF states. 
Then define your application fields over this background field. When the user 
touches one of your fields, you receive the buffer you expect. But if the user 
touches any other part of the screen , you receive the buffer associated with 
the background field. 


’Clear screen; position cursor at top 
’Define a touch field 
’Turn on touch-field sensing 
’Read one character from touchscreen 
or from keyboard 
’Turn off sensing 
’Go off on option 1 
’Not option 1, return for more 
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CONTROLLING THE KEYBOARD 

Some applications on the HP 150 need more control over the keyboard than is 
required for data entry alone. Some of the functions that you may want to trap 
in your applcation are listed below: 

o Cursor Control Keys 

o [Next] and [Prev] Keys 

o Scroll Up and Scroll Down Keys 
o Character and Line Manipulation Keys 

In general, keyboard functions that can be executed by escape sequences can be 
trapped. To trap keyboard functions, you should enable Transmit Function Key 
mode. This mode causes the terminal to transmit the escape sequence associated 
with the function, instead of executing the function normally. 


Transmit Function Key Mode 

You control the Transmit Function Key mode by setting or clearing the "A" strap 
in the HP 150 Terminal Configuration Menu. The user can do so (see the HP 150 
Personal Computer Owner's Guide for details) or else you can use the following 
escape sequence: 

ESC Sc s 1 A Enable Transmit Function Key mode 

ESC Sc s 0 A Disable Transmit Function Key mode 

For example, if you press [Clear line], in normal operation, the terminal erases 
all of the characters that appear between the current cursor position and the 
end of the line. In Transmit Function Key mode, the terminal sends two 
characters (ESC K) to your application. The HP 150 does not erase data to the 
end of the line unless your application echos or prints the two characters to 
the display. 

The two-character escape sequence (ESC K) returned to your application is the 
same sequence that clears a line. The characters returned to your application 
in Transmit Function Key mode are always the escape sequence characters that 
correspond to the function of the key. 

The terminal executes the function only when the function is echoed to the 
console. Therefore, your application should use a console input statement that 
does not echo to the console. The following BASIC program segment contains an 
example of such an input statement. In this segment, once Transmit Function Key 
mode is enabled, the only control key that is executed is the [Clear line] key, 
which generates ESC K. 
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1000 PRINT CHR$(27); "&klA" 
2000 CH$ = INPUT$(1) 

2010 IF CH$ <> ESC$ THEN 2070 
2020 CH$ = INPUT$(1) 

2030 IF CH$ = "K" THEN 2050 
2040 GO TO 2000 
2050 PRINT ESC$;"K"; 

2060 GO TO 2000 
2070 PRINT CH$; 


’Go get another character 
’Not an escape sequence, so echo 
’ the key! 


’Enable Transmit Function Key mode 
’Read one character without echo 
’Not ESC character 
’Read the next -character 
’Clear Line 


Programming Considerations 

Transmit Function Key mode gives you additional control over the HP 150. When 
using this mode, keep the following points in mind. 

First, if you set Transmit Function Key mode ON when your application starts, be 
sure to turn it OFF when you exit your application. This action puts the HP 150 
in its default state, and ensures that your application does not disrupt other 
applications. 

The Transmit Function Key mode causes the terminal to send an escape sequence to 
your application. The sequence you receive is the same sequence which, if sent 
by your application, would perform the same task as the key. Thus, to control 
the keyboard properly, your application should perform input without echo. This 
way, your application receives the associated escape sequence and can determine 
a suitable course of action before the HP 150 performes the task. 

You should also remember that the default value of each user-defined softkey 
returns a two-character escape sequence. These default values are listed below: 

[fl] ESC p 

[f2 j ESC q 

[f3 j ESC r 

[fU] ESC s 

[f5] ESC t 

[f6] ESC u 

[f7 j ESC v 

[f8] ESC w 

Although you can use these default values, you may find it easier to define the 
softkeys to fit your application. 

Finally, some keyboard controls do not generate escape sequences. For these, 
you will need to use AGIOS. With AGIOS, you can specify all of the keyboard 
control keys or ’special’ keys to execute normally, to be intercepted by your 
application, or to be ignored. If you need more control than is available via 
the Transmit Function Key mode, you will need to incorporate AGIOS functions 
into your application. For more information, see "Keycode Mode" and "Keyboard 
Intercept" in the section on Alphanumeric Input/Output Subsystem Function 


Reference. 
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CONTROLLING THE DISPLAY 


The display enhancements that the HP 150 supports include video enhancements and 
alternate character sets. You can also ’turn off’ the alphanumeric display, 
either with or without having this action affect the softkey labels. 

Display Enhancements 

Four types of display enhancements are available on the HP 150: Blinking, 
Inverse, Underline, and Half-Bright. You can use these enhancements one at a 
time or in any combination. 

The general format of the escape sequence that enables enhanced text is: 

ESC & d <enh> 

This escape sequence lets you specify that the display enhancement indicated by 
<enh> will be in effect from the present cursor position to the end of the 
current line. The following table lists the value for <enh>: 

Table 2-2. Display Enhancements Table 


<enh> gABCDEFGHIJKLMNOS 


Blinking 

Inverse 

Underline 

Half-Bright 

No Enhancement 

Security 



Security as an enhancement lets you define an area in which text will not be 
echoed to your screen. This type of enhancement is useful when you do not want 
the actual text to display on the screen, such as when entering a password. 

Once enabled, an enhancement remains ON until it is turned off (via an escape 
sequence in which <enh> is ’@’), or until the cursor is moved to a different 
line. 
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Selecting a Character Set 

The HP 150 includes several character sets that you can include in your 
application. These sets are described below: 

Character Set Description 

Base The system’s base set. This is normally the U.S. ASCII 

character set. 

Math This is a set of mathematics characters, indicating Greek 

letters and various symbols. 

Line The Line-Drawing set lets you use various line segments, 

comers, and symbols. 

Two other character sets can be accessed only through AGIOS functions: an 
Italics character set and a Bold character set. "Video Intrinsics" in Section k 
contains more information about using those character sets. 

The escape sequence for selecting an alternate character set is: 

ESC ) <cset> 

Values for <cset>, the character set selection, are listed below: 

@ = Base set selected as alternate character set 
A = Math set selected as alternate character set 
B = Line-Drawing set selected as alternate character set 

Once you have selected one of these sets as the alternate set, you can shift 
between the base set and the alternate set by means of the ASCII Shift-Out (SO) 
and Shift-In (SI) characters. The decimal values for these characters are 14 
and 15, respectively. From the keyboard, you shift out to an alternate set by 
simultaneously pressing the [CTRL] and "N" keys. You shift in to the base set 
by simultaneously pressing the [CTRL] and "0" keys. 
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You can use the alternate set by printing the ASCII character that corresponds 
to the desired character, as shown in the following table: 


Table 2-3. Alternate Character Sets 


<cset> 


Character Set Equivalents 


Line Drawing Set 


fflffl®OO®OS0© 



Math Set 
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You can use this table to write programs that draw boxes and lines, that use 
special math symbols, and that even enhance these special characters. Here is a 
sample BASIC program that draws a rectangle on the screen: 

2500 ’Print a box with ’Hello There" in the middle 

2510 PRINT CHR$(27)’Select Line Drawing as Alternate" 

2520 PRINT CHR$(lU);"Q;;;;;;W" ’Top line 
2525 ’ Now print middle line with normal" characters 
2530 PRINT CHR$(14);":";CHR$(15);" Hello There 

2540 PRINT CHR$(l4);":" ’Other end of box 

25^5 * That concludes the middle line 

2550 PRINT CHR$(l4);"A;;;;;;;;;;;;;;;;;;;;;;S" ’Bottom of box 


Note that to print the "normal" characters inside the box, you must shift back 
to the primary character set (lines 2525 through 25 U 5 ). 

This program produces the following figure: 


Hello There 


Alphanumeric Memory Control 

The alphanumeric screen and the graphics screen are independent. Therefore, 
both of these screens can be displayed together, or either can be displayed 
alone. If Graphics Text mode is ON, then alphanumeric characters are written 
into graphics memory. This mode is controlled totally within graphics 
operations. 

In the alphanumeric memory, you can turn off the entire display (including the 
softkeys); or else you can turn off any text and leave the softkey labels ON. 
To perform these tasks, use the following escape sequences: 


ESC It w 12 F 
ESC & w 13 F 
ESC * d E 
ESC * d F 


Alpha Display ON 

Alpha Display OFF (softkey labels remain) 
Alpha Memory ON 

Alpha Memory OFF (including softkey labels) 


Appendix D, entitled "Graphics 
about the latter two sequences 


Control Functions," contains more information 
(ESC * d E and ESC * d F). 
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Programming Considerations 

When you use display enhancements and alternate character sets, keep in mind how 
the HP 150 works. When the display is cleared, none of alpha memory is 
allocated. When you position the cursor and turn on a display enhancement, that 
enhancement affects all bytes on that line that are allocated now or that may be 
allocated in the future. 

For example, position the cursor in column 5 on the first row. Invoke the 
’inverse video’ enhancement by using the escape sequence ESC & d B. Now print 
several characters; they will appear in inverse video. If your application 
leaves the first line and then returns to column 70 on the first line, the next 
characters you print will cause the entire line to appear in inverse video. 

This change occurs even if you do not include the 'inverse video' sequence at 
column 70i 

To avoid this situation, you should turn on inverse video; print the text that 
you want to appear in inverse; and turn off inverse video (by using the ESC & d 
@ sequence). Thus, repositioning the cursor to the right on the same line will 
not cause the entire line to be enhanced. 

Alternate characters work the same way. Once you have shifted out (SO) to an 
alternate set, all characters to the right will also be shifted, unless and 
until you print a shift-in character (SI). 
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USING THE KEYBOARD AND THE DISPLAY 

When the following two-character escape sequences are executed from a program, 
they perform functions that you can also perform from the keyboard. The HP 150 
Terminal User's Guide contains additional information about these escape 
sequences. 

Two-Character Escape Sequence 



Table 2-4. Two-Character Escape Sequences 

Escape 

Sequence 

Function 

ESC 0 

Copy information in display memory to destination^) 

ESC 1 

Set tab 

ESC 2 

Clear tab 

ESC 3 

Clear all tabs 

ESC 4 

Set left margin 

ESC 5 

Set right margin 

ESC 6 

Define alphabetic-only field to be used by Format mode 

ESC 7 

Define numeric-only field to be used by Format mode 

ESC 8 

Define unrestricted field (alphabetic or numeric 
characters) to be used by Format mode 

ESC 9 

Clear all margins 

ESC g 

Delay one second 

ESC A 

Move cursor up one line 

ESC B 

Move cursor down one line 

ESC C 

Move cursor right one space 

ESC D 

Move cursor left one space 

ESC E 

Hard reset (power-on reset) 

ESC F 

Home cursor down (to lower left corner of display) 
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Escape 

Sequence 

Function 

ESC G 

Move cursor to left margin 

ESC H 

Home cursor up (to upper left corner of display) 

ESC I 

Horizontal tab 

ESC J 

Clear display from cursor to end of display memory 

ESC K 

Clear line from cursor to end or line 

ESC L 

Insert one blank line 

ESC M 

Delete one line 

ESC N 

Turn on Insert Character with wraparound mode 

ESC 0 

Delete one character at current cursor position 
with wraparound 

ESC P 

Delete one character at current cursor position 
without wraparound 

ESC Q 

Turn on Insert Character mode (insert character 
without wraparound) 

ESC R 

End Insert Character mode 

ESC U 

Next Page 

ESC V 

Previous Page 

ESC W 

Format mode ON 

ESC X 

Format mode OFF 

ESC Y 

Display Functions mode ON 

ESC Z 

Display Function mode OFF 

ESC [ 

Start unprotected field 

ESC ] 

End unprotected/transrait-only field 

ESC A 

Primary terminal-status request 

ESC _ 

Write non-displaying terminator 

ESC ' 

Sense cursor position (relative) 
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Escape 

Sequence 

ESC a 

ESC b 

ESC c 

ESC d 

ESC f 
ESC g 
ESC h 

ESC i 
ESC j 

ESC k 

ESC 1 
ESC m 
ESC p 
ESC q 
ESC r 
ESC s 
ESC t 
ESC u 
ESC v 
ESC w 
ESC x 
ESC z 


Function 

Sense cursor position (absolute) 

Unlock keyboard 
Lock keyboard 

Transmit a block of text to computer (simulate the 
ENTER key) 

Disconnect Modem 

Soft reset 

Home cursor up to the first unprotected field 
(ignoring transmit-only fields) 

Backtab 

Display User-Definable Function key menu and begin 
User Key Definition mode 

Restore normal display and end User Key Definition 
mode 

Begin Memory Lock mode 
End Memory Lock mode 


Default 

definition 

for 

user-definable 

function 

key 

fl 

Default 

definition 

for 

user-definable 

function 

key 

f2 

Default 

Definition 

for 

user-definable 

function 

key 

f3 

Default 

Definition 

for 

user-definable 

function 

key 

fU 

Default 

Definition 

for 

user-definable 

function 

key 

f5 

Default 

Definition 

for 

user-definable 

function 

key 

f6 

Default 

Definition 

for 

user-definable 

function 

key 

f7 

Default 

Definition 

for 

user-definable 

function 

key 

f8 


Initiate datacomm self-test 
Initiate terminal self-test 
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Escape 

Sequence 

Function 

ESC { 

Start transmit-only field 

ESC | 

Erase non-displaying terminator (for use in Format 
mode) 

ESC - 

Secondary terminal-status request 
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Display Structure 

The display portion of the terminal consists of the display memory and the 
display screen. Display memory is the portion of terminal memory that contains 
alphanumeric data entered to the terminal or displayed on the screen. Display 
memory consists of 48 rows (numbered 0 through 47) and 80 columns (numbered 0 
through 79)• 

The display screen, which is the visible part of display memory, consists of 27 
rows. Each row contains space for 80 characters (numbered 0 through 79). The 
first 24 rows of the display screen shows one "page” of display memory. Rows 25 
and 26 display the function-key labels ("softkeys"). Row 27 contains 
information about the terminal’s status, and also shows the current date and 
time. 

As data is added to display memory, all of display memory will eventually be 
used. When display memory is full, lines are rolled off the top of the display 
and they are lost. The Status line indicates the number of lines entered into 
display memory. 

The cursor, which appears on the screen as a blinking underscore mark or a 
blinking box in inverse video, indicates where the next character entered will 
appear. The cursor appears only on the display screen. 


Memory Addressing 


Display memory can be addressed using absolute or relative coordinate values. 

The three types of addressing are listed below: 

o Absolute 
o Screen-Relative 
o Cursor-Relative 

In absolute addressing, you specify the row and column in display memory. 

Column values range from 0 through 79» and row values range from 0 through 47. 

In screen-relative addressing, you specify the position relative to the ’window’ 
where the first line on the screen is row 0. If scrolling has occurred, for 
example, screen relative row 0 may be absolute row 10. 

In cursor-relative addressing, you specify a position relative to the current 
cursor position by specifying signed row and column values. A plus sign ("+") 
indicates movement to the right or down; a minus sign ("-") indicates movement 
to the left or up. 

If the row or column addresses are greater than the available addresses, the 
largest possible value is used. In screen-relative addressing, the cursor 
cannot be moved to a row position that is not currently displayed. 
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The cursor control operations are described below: 


Escape Sequences 

ESC & a <col> c <row> R 

ESC tc a <col> c <row> Y 


Function 

Moves the cursor to column <col> and row <row> in 
display memory (Absolute addressing) 

Moves the cursor to column <col> and row <row> in 
screen memory (screen relative addressing). 


ESC & a <scol> c <srow> Y Moves the cursor to column <scol> and row <srow> on 

the screen relative to its present position. The 
<scol> and <srow> parameters represent signed numeric 
ASCII characters. A positive number indicates 
movement up or to the right; a negative number 
indicates movement down or to the left. 


ESC & a <scol> c <srow> R Moves the cursor to column <scol> and row <srow> 

relative to its present position in memory. 


You can use a combination of display-screen, display-memory, and cursor-relative 
coordinates in one escape sequence. 


Examples : 

1. The following escape sequence positions the cursor at column TO, 18 rows 

below the current cursor location. (If necessary, text will scroll up so 

that the cursor can be moved to the specified line.) 

ESC & a 69 c + 18 R 

2. The following escape sequence positions the cursor 15 columns to the left of 

the current cursor position, in the 4th row currently visible on the display 

screen. 

ESC & a -15 c 3 Y 

3. The following escape sequence positions the cursor at column 5 on the 
current row: 

ESC & a 4 C 
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Programming Considerations 

In cursor positioning, you should be aware of the effect of memory lock. When 
memory lock is enabled, ’freezing’ part of the text at the top of the screen, 
absolute memory addressing does not function properly. For safety’s sake, 
always use screen-relative addressing. 

If you do not want to scroll, you can effectively disable it by using the 
Transmit Function Key mode in combination with ’home up’ commands whenever you 
paint a form on the screen. This technique lets you capture the scrolling 
functions, and ensures that your addressing is always correct. Transmit 
Function Key mode is explained earlier in the section on Controlling the 
Keyboard. 


2-33 



Escape Sequence Programming 


MODE SELECTIONS 


You can use escape sequences to change the active values of the mode function 
keys and terminal configuration parameters listed in Table 2-5 below. A change 
in a parameter value made through one of the sequences listed below takes effect 
immediately. However, the values in non-volatile memory are not changed; that 
is, the default values are restored when you restart your operating system. If 
a configuration menu is displayed on the screen when the terminal receives the 
escape sequence, the sequence is not executed until you exit from the menu. 

You can use an escape sequence to lock the current configuration menus so that 
they cannot be altered from the keyboard or from a program. Any attempt to gain 
access to a locked menu causes a "beep" from the bell, and generates an error 
message. When the configuration menus are locked, the MODIFY ALL, BLOCK MODE, 
REMOTE MODE, and AUTO LF function keys are also locked. 

To lock the menus, use the following escape sequence: 

ESC &q 1L 

To unlock the menus, use the following escape sequence: 

ESC fcq OL 


Mode Selection Escape Sequences 


The following escape sequences select active values without changing the values 
in non-volatile memory. Entries in the MENU FIELD/MODE column that are marked 
with an asterisk appear on the Terminal Configuration Menu. These fields are 
defined in the Function Keys chapter in the HP 150 Terminal User's Guide . 
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Table 2-5. Mode Selection 


ESCAPE 


MENU FIELD/ 


SEQUENCE 

MODE 


1 x 

ESC 

&k 

<x>A 

Auto Lf 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>B 

Block Mode 

| OFF 

| x=0 





j ON 

| X=1 

ESC 

&k 

<x>C 

*Caps Lock 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>D 

*Bell 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

& k 

<x>I 

*ASCII 8 Bits 

| NO 

| x=0 





| YES 

| X=1 

ESC 

&k 

<x>K 

Auto Keyboard 

| OFF 

| x=0 




Lock mode 

j ON 

| X=1 

ESC 

&k 

<x>L 

*Local Echo 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>M 

Modify All 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>N 

SPOW(B) 

j OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>0 

Numeric/ 

| Numeric 

| x=0 




Graphics pad 

| Graphics 

| X=1 

ESC 

&k 

<x>P 

Caps mode 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

Sc k 

<x>Q 

Click 

j OFF 

| x=0 





| ON 

| X=1 

ESC 

&k 

<x>R 

Remote Mode 

| OFF 

| x=0 





| ON 

| X=1 

ESC 

Sc s 

<x>A 

*XmitFnctn(A) 

| NO 

| x=0 





| YES 

| X=1 

ESC 

Sc s 

<x>B 

*SPOW(B) 

| NO 

| x=0 





| YES 

| X=1 

ESC 

Sc s 

<x>C 

*InhEolWrp(C) 

| NO 

| x=0 





| YES 

| X=1 


VALUES 


VALUE OF 
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ESCAPE 

SEQUENCE 

ESC Scs <x>D 

ESC Scs <x>G 

ESC Scs <x>H 

ESC &s <x>J 

ESC ks <x>K 

ESC &s <x>L 

ESC Scs <x>N 

ESC Sc s <x>W 

ESC &x <x>C 


MENU FIELD/ | 
MODE j 

1 

VALUES 

|VALUE OF| 

1 x | 

1 

*Line/Page(D)| 

LINE 

1 x=0 | 

1 

1 

PAGE 

1 x=l | 

*InhHndShk(G)| 

NO 

1 x=0 | 

1 

1 

YES 

1 x=l | 

*Inh DC2(H) | 

NO 

1 x=0 | 

1 

1 

YES 

1 x=l | 

*Auto Term(J)| 

NO 

1 x=0 | 

1 

1 

YES 

1 x=l | 

1 

*ClearTerm(K)| 

NO 

1 x=0 | 

1 

1 

YES 

1 x=l j 

1 

*InhSlfTst(L)| 

NO 

1 x=0 | 

1 

1 

YES 

1 x=l | 

1 

*ESC Xfer(N) | 

NO 

1 x=0 j 

1 

1 

YES 

1 x=l | 

1 

*InhDcTst(W) | 

NO 

x=0 | 

1 

1 

YES 

1 x=l j 

Send Cursor | 

OFF 

1 x=0 | 

Position | 

ON 

1 x=l | 
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Programming Considerations 

When your application first executes, you should send a ’set-up string’ to the 
HP 150 to initialize the state of all the straps and modes. 


The following sequence is a good starting point for all applications: 

ESC & k 0 a Auto Line Feed OFF 

0 b Block mode OFF 

0 c Caps Lock OFF 

1 d Bell ON 

0 i ASCII 7 bit mode 

0 k Keyboard Lock OFF 

0 1 Local Echo OFF (MS-DOS echoes character) 

0 m Modify All mode OFF 

0 n Space Overwrite mode OFF 

0 o Numeric Keypad ON 

0 p Caps mode OFF 

1 Q Keyclick ON 

You should also consider using the following escape sequences: 

ESC & s 0 a Transmit Function Keys OFF* 

0 b Space Overwrite disabled 

0 c Inhibit end-of-line wraparound 

0 d Line mode enable 

1 g Inhibit Block mode handshaking 

1 h Inhibit DC2 Trigger 

0 j Auto Terminator disabled 

0 k Clear Terminator mode OFF 

1 1 Inhibit Self-Test 

0 n Escape sequence transmit to printer disabled 
1 W Inhibit DataComm Test 

*If you want to use the Transmit Function Keys mode, this parameter 
will be 1 a. 
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FORMAT MODE 

Format mode lets your application transmit data from unprotected fields on the 
screen to a host computer. You define unprotected fields when Format mode is 
disabled. When Format mode is enabled, you can enter and transmit data. (See 
the HP 150 Terminal User’s Guide for additional information on defining fields.) 

Defining Fields 

From an application, you can use the following escape sequences to define 
"unprotected" and "transmit-only" fields with the various screen attributes: 


ESC [ 

Starts an unprotected field 

ESC { 

Starts a transmit-only field 

ESC ] 

Ends a field 

ESC & k <x> Z 

The data is transmitted when the ENTER key is pressed, 
according to the following values for <x>: 

0 = Transmits data within the unprotected and 
transmit-only fields (default) 

1 = Transmits data within transmit-only fields, 

and within any unprotected fields that have been 
modified. 


The two-character escape sequences ESC 6, ESC 7, and ESC 8 define various 
attributes of each field or subfield. The meanings of these sequences are 


listed below: 


ESC 6 

Specifies an alphabetic field only. No numerical or special 
characters are accepted. 

ESC 7 

Specifies a numerical only field. No alphabetical or special 
characters are accepted. 

ESC 8 

Specifies an unrestricted field. Any character (alphabetical, 
numerical, or special) can be entered within this field. 


The same sequence of operations applies when fields and subfields are defined 
programmatically as when they are defined through the keyboard. For example, if 
you want a field to include video enhancements, you must send the appropriate 
ESC & d sequence before sending ESC [ or ESC { sequence. To define the start of 
a subfield, you must first send the appropriate sequence (ESC 6, ESC 7, or ESC 
8) at the point where the subfield is to begin. 
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Forms are defined when Format mode is disabled. However, forms are not 
intepreted as such until Format mode is enabled. When Format mode is initiated, 
all of the display memory is "protected ", except for the portions that have 
been explicitly defined as "unprotected" and "transmit-only" fields. 

You can use the following escape sequences to enable and disable Format mode 
programmatically: 

Enable Format mode : ESC W 
Disable Format mode : ESC X 


Transferring Forms from the Screen to a Host Computer 

When writing application programs that will display a form on the terminal 
screen, you may decide to code the program statements that issue the necessary 
escape sequences, shift-out (SO) and shift-in (SI) codes, and data. If the form 
structure is complex, this method can be both tedious and prone to error. 

An easier way is to design the form at the terminal when it is not connected to 
either a remote host computer or MS-DOS. And then transfer the form structure 
from the screen to the host computer, where it can be accessed by or 
incorporated into your program. If the terminal is connected to an HP 3000 
Computer System, you can use the FORMSPEC portion of V/3000, and then include 
appropriate V/3000 intrinsic calls in your application programs to use the form 
while an application program is executing. 
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BLOCK TRANSFERS 


The HP 150 normally operates in Character mode, sending each character to the 
host as the key is pressed. The HP 150 can also operate in Block mode, in which 
data is sent to the host one block at a time. Block mode requires special 
handshaking with the host. (As used here, ’Host’ indicates a remote system or 
the MS-DOS operating system.) 

Even in Character mode, certain transfers occur in Block mode (all of which 
occur in Remote mode). 

o A transfer is initiated when the Enter key is pressed. 

o A transfer is initiated by the escape sequence ESC d (the Enter key 
sequence). 

o Data is transferred when Line Modify or Modify All mode is ON. 

o The definition string of a "Transmit” type user-defined softkey is 
transferred when the key is pressed in Remote mode. 

o Status-data transfers (such as information about the cursor position or about 
the terminal status) are requested. 

The actual protocol of the data transfer depends on how the following 
configuration switches are set. 


Terminal Parameter: 

Line/Page (D) 
InHndShk (G) 

Inh DC2 (H) 
AutoTerm (J) 
ClearTerm (K) 


Default Setting: 

Line 

No 

No 

No 

No 


Block/Character, Line Modify/Modify All, Format, and Auto Line Feed modes also 
affect data transfer. The following table shows the configuration menu settings 
that let you select each mode. 
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Table 2-6. Data Transfer Settings 


TRANSFER 

| HANDSHAKE 

MODE 

1 

G 

H 

TYPE 

TYPE 

1 

1 

1 

1 

STRAP 

| STRAP 

Enter key 

| None 

| Character 

1 

1 

1 

No 

1 


| None 

i 

1 

1 

i 

- 

| Yes 


| DC1 

i 

(Option 

i i 

not ava 

liable) 


| DC1/DC2/DC1 

i 

| Block 

1 

i 

1 

1 

- 

No 


| DC1/DC2/DC1 


1 

1 

1 

Yes 

No 

Status and 

| None 


1 

1 

Yes 

| Yes 

ESC d 

| DC1 

1 

1 

l 

1 

1 

1 

i 

No 

_ 


| DC1/DC2/DC1 


1 

I 

Yes 

No 

User-defined 

| None 

1 

| Block Page 

1 

1 

_ 

Yes 

function key 
(Transmit) 

| None 


1 

1 

1 

Yes 

Yes 


| DC1 

| Block Line 

l 

1 

1 

l 

No 

- 


| DC1 

| Character 

i 

1 

1 

I 

No 

1 


| DC1/DC2/DC1 


1 

1 

1 

Yes 

No 


| DC1/DC2/DC1 

| Block Page 

1 

1 

1 

1 

- 

No 

Modify modes 

| None 


1 

1 

1 

- 

Yes 


| None 

i 

1 

1 

i 

No 

No 


| DC1 

i I 

(Option 

i i 

l 

not available) 

i 


| DC1/DC2/DC1 

i 

i 

1 

1 

Yes 

No 


NOTE 


A symbol in the above table indicates a "don’t care" 
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To accept a Block mode transfer programmatically, you must 
perform the following steps: 

1. Disable Auto Line Feed 

2. Use the correct form of handshaking 

3. Decide on the most appropriate way to receive data 

These steps are explained in the following paragraphs. 


Handshaking 


In general, the InhHndShk(G) (Inhibit Handshake, strap G), and InhDC2(H) 

(Inhibit DC2, strap H) selections on the Terminal Configuration Menu determine 
the type of transfer handshaking to be used when transferring blocks of data 
from the terminal to the host computer. You can use the ESC & s sequence to set 
the G and H straps. 

The following three handshakes are possible: 

1. No handshake (Type 1), in which the terminal simply sends the data block 
without any special control from the host system. This handshake occurs 
when both the ’G’ and ’H’ straps are set. 

InhHndShk (G) = Yes 

Inh DC2 (H) = Yes or ESC & s 1 g 1 H 

2. A DC1 Trigger handshake (Type 2), in which the host computer must trigger 
the block transfer with a DC1 character. This handshake occurs when the ’G* 
strap is not set and the ’H’ strap is ignored. 

InhHndShk (G) = No 

Inh DC2 (H) = Yes or No or ESC & s 0 g 0 H 

3. A DC1/DC2/DC1 handshake (Type 3), in which a DC1 from the host is answered 
by a DC2 from the terminal. The host must respond with a second DC1. When 
this response occurs, the terminal transmits the data. This handshake 
occurs when the *G* strap is not set and the ’H’ strap is set. 

InhHndShk (G) = Yes 

Inh DC2 (H) = No or ESC & s 1 g 0 H 
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Correct Handshaking 


The Microsoft languages do not output a DC1 as a signal that they are ready to 
receive data. If the terminal configuration is set for the default handshaking 
scheme (DC1/DC2), and if a program outputs an escape sequence asking for a Block 
mode transmission, the terminal will lock up while it waits for the DC1 trigger. 
At this point, you will see the message "KB Locked" in the lower left corner of 
your screen. To eliminate this problem, many users disable handshaking 
entirely. Although this tactic works in most cases, it can cause data overruns. 
Another disadvantage is that the user must re-enable handshaking each time he or 
she wants to access a host system. 

A more conservative approach is to leave DC1/DC2 handshaking enabled and have 
the program output the DC1 trigger. The following BASIC program segment 
illustrates this procedure: 

1000 REM Read one line from the display 
1010 PRINT CHR$(27);”d";CHR$(17); 

1020 LINE INPUT TEXT$ 

The PRINT statement outputs an ESC d to request the transfer of one line from 
the display, and then outputs a DC1 to inform the terminal that the program is 
ready to receive. 

With regard to compatibility, a program that does not output its own DCls must 
be run on a system on which handshaking is disabled. If the program does output 
its own DC1, it will run regardless of whether handshaking is disabled. If the 
DC1/DC2 handshake is disabled, and if the terminal receives the DC1 sent by your 
program, the terminal will simply ignore it. 


Disable Auto Line Feed 

When Auto Line Feed is enabled, all block transfers are preceded by a line-feed 
character. This condition can cause misalignment of the cursor before the 
transfer begins; it can also cause difficulties in reading the data transmitted. 
Therefore, we recommend that you disable Auto Line Feed. 

You can use the following escape sequence to disable Auto Line Feed: 

ESC & k 0 A 


The Appropriate Way to Receive Data 

The most common block-mode transmissions are generated by one of the three 
escape-sequence groups shown below: 

1. ESC d (simulates the Enter key) 

2. Status Request (includes device control status) 

3. Function Key/Device-Read format 
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If you are using the first sequence (ESC d), you should consider using the 
approach shown in the example in the Correct Handshaking section. For the 
second and third sequences, you can use either of the two procedures described 
below, depending upon whether the length of the transmission is known to the 
program, or whether the length of the transmission may vary. Most status 
requests return a fixed number of characters, depending upon the request. The 
function keys and device-reads can return a text line of any length. 

If the length of the transmission is known, the following Microsoft BASIC 
example works well. This example uses the INPUT$ function to read the 
information. INPUT$ does not echo the information, but must know how many 
characters to read (including any Carriage Return or Line Feed characters that 
may be returned): 

1000 REM Get the current alpha cursor position 
1010 PRINT CHR$(27);"a";CHR$(17); 

1020 A$=INPUT$(12) 

1030 PRINT MID$ (A$,2) 

You must accept 12 characters because the reported cursor position is sent in 
the form: 

ESC & a nnn c mmm R <Carriage Retum> 

where ’nnn’ is the column number and ’mmm’ is the row number. Note that 
printing this same sequence would reposition the cursor to its current location. 
However, printing with the MID$ function in line 1030 does not move the cursor. 

If the length of the transmission can vary according to the item’s current 
definition, you must use another approach. In the following BASIC example, the 
LINE INPUT statement echos characters if the application is reading from the 
standard input device. If the application is reading from a file, then it has 
no need to display the information on the screen. The following example assigns 
the CONSOLE (terminal) as an input file, and uses LINE INPUT# to read the 
information: 

1000 REM Read the text in softkey #1 
1010 PRINT CHR$(27);"&flE";CHR$(17) 

1020 OPEN "I",1,"CON" 

1030 LINE INPUT #1,TEXT$ 

10U0 CLOSE 1 

The text in softkey 1 must end with a carriage return. 
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DATA OPERATIONS 


This section describes escape sequences that control data transfer from a host 
system or an application program to the internal, external, and/or HPIB 
printers. A host system or an application program can send data already stored 
in display memory or data directly from the program to any selected printer. 

The following paragraphs describe the concepts and the escape sequences are 
listed after. 


Selecting a Printer as the Destination Device 

To control your printer, you must select it as the destination device for device 
control commands. The destination devices are selected programmatically by 
including one or more <d> parameters in the device control escape sequences 
(more than one destination device can be selected). The escape sequence to 
select destination devices is: 

ESC &p <a> d <b> d <c> D 

The values for <a>, <b>, and <c> may be 4, 5, or 6. The option code "4" selects 
the printer indicated by the PrinterCodeU entry on the Terminal Configuration 
menu. The PrinterCodeU entry lets you choose between an external RS232 printer 
or the internal printer. The option code "5" selects an HPIB printer and the 
option code "6" selects the internal printer. If no <d> parameter is specified, 
then the currently assigned destination device(s) is used. 

In addition to the above escape sequence, there is a level of system softkeys 
that lets you examine and select printer devices. You access the printer device 
softkeys by pressing the following key sequence: 

o [User System] 
o [device control] or [fl] 
o ["to" devices] or [f3] 

This level of softkeys lets you select a serial device, the internal printer, or 
an HPIB device as the printer destination device. Using one of the escape 
sequence options (4, 5> or 6) alters the softkey selection accordingly. 


2-45 






Escape Sequence Programming 


NOTE 


The "ESC & p <a> D" sequence usually puts an asterisk in 
the selected "to" device softkey label; however, an ESC 
& p 5D sequence will not cause am asterisk to be 
displayed on the "HPIB" softkey label. 

Although the ESC & p 5D sequence does not display an 
asterisk in the "HPIB" softkey label, the HPIB printer 
is selected. If you press the HPIB "to" device softkey, 
you will get a "Device Busy" error message when you try 
to send data to the HPIB printer. To un-select the busy 
device, you cam send am escape sequence to select a 
different device, such as the internal printer (ESC & p 
6D). 


Selecting a Source Device 

To transfer data from the alphanumeric or graphics display memory to a selected 
printer, you must set the alphamumeric or graphics memory as the source device. 
Selecting alpha memory will cause data to be moved from alpha memory to the 
selected printer. Selecting graphics memory will result in a raster dump to the 
printer. 

You cam combine the source amd destination assignments and the transfer 
initiation in one sequence: 

ESC &p 7s 6d F 

defines graphics memory as the source (7s), defines the internal printer (6d) as 
the destination, amd copies the entire graphics display memory to the 
destination. The values for source devices amd destination devices are listed 
later in this section. 
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Paper Movement 

Two paper movement operations are allowed: line feed (advance line), and form 
feed (advance page). If the internal printer has been selected as the device, a 
form feed can be produced only in Report or Metric modes (see the next section 
on Printer Modes). If a form feed on an internal printer is attempted while not 
in Report or Metric mode, a line feed will be generated in place of the form 
feed. 


Printer Modes 

There are two printer modes: Record mode and Data Logging mode. They are 
available on the internal, external, and HPIB printers. 


RECORD MODE: In Record mode, data is copied from the remote computer or a 
local application to the selected destination devices; data is not displayed on 
the screen. If Record mode is turned off with a partially-filled buffer, the 
contents of the buffer are sent to the destination device(s). 


DATA LOGGING MODES: There are two Data Logging modes: Log Top mode, and Log 
Bottom mode. When alpha display memory is filled (48 lines), and one more line 
of data is received over a datacomm line, the top line in display memory is 
"purged" to make room for the new line. 

With top logging, each line that is purged from the top of the display is sent 
to the selected printer. Thus, while the line is "lost" from display memory, it 
is kept in printed form. 

With bottom logging, each time the cursor moves from one line to another line as 
the result of a line feed or an end-of-line wraparound, the line from which the cursor 
moved is printed. This feature allows you to maintain a hard copy "trail" of 
all lines added to display memory in the order they were received. 
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Terminal to Printer Data Transfers 

A selected line, all or part of a displayed page, or all or part of the active 
workspace (display memory) can be copied from the terminal to a printer. This 
can be done via the following escape sequence: 

ESC &p <y> 

The option values for the < y > parameter is listed later in the section on Data 
Transfer Escape Sequences. Printing begins at the current cursor line. You 
must select a printer as the destination device. When printing is initiated 
from the keyboard, the display is automatically defined as the source device. 


COPY A SELECTED LINE: When either an external printer, the internal printer, or 
an HPIB printer is selected as a destination device, you can copy the line 
containing the cursor from the display to a printer. 


COPY PAGE: When either an external printer, the internal printer, or an HPIB 
printer is selected as the destination device, you can copy all lines, starting 
with the line containing the cursor through the last line visible on the screen, 
to the printer. 


COPY ALL: When either an external printer, the internal printer, or an HPIB 
printer is selected as a destination device, you cam copy all lines, starting 
with the line containing the cursor through the last line of display memory, to 
the printer. 

For the above operations, the internal printer is the only destination device 
that copies amy escape sequence directly from the display to the printer. The 
serial printer or the HPIB printer will try to interpret the escape sequence 
instead. 

In all copy operations, block terminators (carriage returns and line feeds) are 
ignored. 


Computer to Printer Data Transfers 

With the printer selected as a destination device, you can copy up to 
256-character records from the computer to the printer. The data can be sent in 
either binary or ASCII form, depending on the escape sequence used. 
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Binary Data Transfer 

If data is to be transmitted to a printer (or other external device) in binary 
(8-bit) form, the device must be of a type that accepts binary data. Also, the 
ENQ/ACK form of handshaking must be used. This means that the computer program 
which initiates the data transfer must transmit an ENQ (ASCII decimal 5); the 
terminal must respond with an ACK (ASCII decimal 6) before the data is 
transmitted. 

The following escape sequence is used to initiate transfer of a string of binary 
data: 


ESC &p <x>W 

This sequence transfers the first "x" bytes of the data string, in binary form, 
to the printer. The maximum value for "x" is 256. 

The sequence of events for transmitting five bytes of binary data ("123^5") to 
an external device from a program, using the ENQ/ACK handshake, is shown below: 

Computer program Terminal 


ESC&p5W > 

ENQ > 

<. ACK 

"123U5" > 


As an alternative to the ENQ/ACK handshake, the program can pause for 3 seconds 
after sending the initiating escape code. 


NOTE 


If data is passed to the display with the eighth bit set, the 
system firmware will try to interpret it as one of its own 
internal display code. Therefore, if the display is selected 
a destination device, sending binary data to it could cause 
unpredictable result. 


as 
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ASCII Data Transfer 

To copy an ASCII data string from the computer to the printer, use the following 
escape sequence: 

ESC &p W <data string> 

The entire data string is copied. The string is terminated either by an ASCII 
line feed character or by the 256 th character. 


Data Transfer from HPIB Device 

To transfer data from an HPIB device, use the following escape sequence to 
select the HPIB "talk" device address: 

ESC &p <x>p 5u 1C 

The parameter <x>p selects the HPIB address <x> as the "talk" device. (See the 
Data Transfer Escape Sequences section for additional information.) 

Once you have selected the "talk" address, you can transfer data from the HPIB 
device (with the current "talk" address) to the computer by the following escape 
sequences: 

For ASCII data terminated with a Line Feed (LF): 

ESC &p 5s R 

For ASCII data not terminated with a LF and binary data, send a byte count 
before transferring data. The terminal will not respond to any further program 
control until the specified number of bytes have been transferred. 

Send Byte Count: ESC &p 5u <byte count>p 6 C 
Send Data: ESC &p 5s R 
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Determining Success of an Escape Sequence 

After issuing a copy line, copy page, copy all, advance line, or advance page 
sequence, the remote program cam determine whether or not the operation was 
successful by executing a BASIC INPUT statement, or similar instruction, that 
requests one ASCII character from the terminal. If the DCl handshaking is used, 
you should send a DCl character (decimal 17) to tell the terminal that you are 
ready to receive the operation status. 

The terminal responds by sending "S", "F", or "U”. "S" indicates successful 

completion, "F" indicates that the operation failed, and "U" indicates that the 
terminal operator interrupted the data transfer by pressing RETURN. "U" cam be 
returned only for a copy page or copy all operation. 

These completion codes camnot be suppressed by configuration parameters or any 
other means. They are always transmitted and your programs should include input 
commands for accepting them. 

The keyboard is disabled ("locked") until the status is sent. 

In either Character or Block Line mode, the terminal sends a <cr> (or <cr><lf> 
if Auto Line Feed mode is enabled) following the completion code. In Block Page 
mode, it sends a block terminator character. 

If a data comm error occurs during transmission of a data record, the device 
control completion code is unpredictable. Datacomm errors are reported by way 
of the terminal status bytes described in the section on Status Requests. 
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Format Modes for the Internal Printer 

The Internal printer permits you to specify three formats for printing: 
Compressed Characters, Report Format, and Metric Format. 


COMPRESSED CHARACTERS MODE: The internal printer can print compressed 
characters in which each print line contains up to 132 characters spaced 16.2 to 
the inch. Once the printing of compressed characters is enabled, it remains 
enabled until it is disabled, until a hard reset is performed, or until the 
system power is turned off. 


REPORT FORMAT MODE: The internal printer normally operates in continuous 
Format mode. You can, however, enable Report Format in which printing is output 
in 66-line pages with a 3-line top margin, 60 lines of text, and a 3-line bottom 
margin. The margins and text area together form an 8 1/2 by 11 inch page. The 
printer uses a small tic mark to mark the end of one page and the beginning of 
the next. 

Once enabled. Report Format remains enabled until disabled, until a hard reset 
is performed, or until the system power is turned off. 


METRIC FORMAT MODE: With Metric Format enabled, printing is output in 70-line 
pages with a 3-line top margin, 6k lines of text, and a 3-line bottom margin. 

The end of one page and the beginning of the next is indicated by a small tic 
mark. Once enabled, Metric Format remains enabled until disabled, until Report 
Format is enabled, until a hard reset is performed, or until the system power is 
turned off. 

If a soft reset is performed while in Report Mode or Metric Format, the printer 
will skip three lines, print a tic mark, and skip three more lines. 
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Data Transfer Escape Sequences 

The escape sequences to control data transfers on the HP 150 are: 

ESC &p <x>S Selects device <x> as the source device. 

<x> DEVICE 

3 Display screen 

7 Graphics display (raster dump to 

selected destination device) 


ESC &p <a>d <b>d <c>D Selects device <a>, <b>, and/or <c> 
as the destination device. 

<a>,<b>,<c> DESTINATION DEVICE 


3 Display screen 

U Internal or external printer dep¬ 

ending on the PrinterCodeU 
entry on the Terminal Configur¬ 
ation Menu 

5 An HPIB device such as a plotter 

or a printer with default 
address at 1 (This selection does 
not display an asterisk on the 
"to” device HPIB softkey label.) 

6 Internal printer 
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ESC ip <y> Copies <y> amount of data to destination 

devices <a>, <b>, and <c>. As many 
destinations as desired can be specified. 


<y> AMOUNT 


b The line in which the cursor is 

located (COPY LINE) 

f From the line in which the cursor 

is located to the last displayed 
line (COPY PAGE) 

m From the line in which the cursor 

is located to the end of display 
memory (COPY ALL) 

ESC &p <x> A Requests the status of device <x>. 

(Refer to the Section on Status 
Requests for more information.) 

<x> DEVICE 


U Internal or external printer dep¬ 

ending on the Printercede4 entry 
on the Terminal Configuration 
menu 

6 Internal printer 


2 - 5 1 * 
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ESC &p <y>u <x>p <z>C Performs the action specified on the selected 
destination device, <y>u. 


<y> 

DEVICE 

3 

Display screen 

4 

Internal or external printer 
depending on the PrinterCode4 entry 
on the Terminal Configuration menu. 

6 

Internal printer 

<z> 

ACTION 

0 

Generates <x> form feeds 

1 

Spaces <x> lines 

2-10 

Generates <x> form feeds 

11 

Turns on Log Bottom mode 

12 

Turns on Log Top mode 

13 

Turns off any logging mode 

14 

Prints normal characters 
(Internal printer only) 

16 

Prints compressed characters 
(Internal printer only) 

17 

Turns on normal Report mode 
(Internal printer only) 

18 

Turns on Metric Report mode 
(Internal printer only) 

19 

Turns off any Report mode. 

(Internal printer only) 

20 

Turns on Record mode; <x> 
is the ASCII decimal value 
(1-127) used to end Record 
mode. Because <x> must be 
in the first character 
position on the line, it 
must be preceded by a Carriage 

Return and a Line Feed. 
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ESC &p <x>p 5u <z>C Selects the HPIB "talk" and "listen" 

device address. The action is selected 
by <z>, as shown below: 

<z> ACTION 


1 Selects <x> as the HPIB "talk" 
device. 

2 Selects <x> as the HPIB 
"listen" device 

ESC &p 5u <z>C Initializes the HPIB device. The action 

is selected by <z>, as shown below: 

< z > ACTION 


3 Enables HPIB timeout 

U Disables HPIB timeout 

7 Initializes HPIB to power on 

configuration. 


ESC Sc p 5s R Transfers ASCII data that is terminated with 

a Line Feed from the HPIB device (with the 
current "talk" address) to the computer. 

ESC &p 5u <x>p 6C For ASCII data not terminated with a Line Feed 

and binary data, this sequence sends a byte 
count <x> before transferring data from the 
HPIB device (with the current "talk" address) 
to the computer. 
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ESC &p <x> W 
<data string> 


ESC ip W 
<data string> 


ESC &k <x>S 


Transfers <x> bytes of the data string 
from the computer or a local application 
to the selected destination device in 
binary form (<x> is a decimal value in the 
range 1 - 256 ). 

Transfers the data string, in ASCII form, 
from the computer or a local application 
to the printer selected as the destination 
device. The string is terminated either by 
the 256 th byte or by an ASCII Line Feed 
character. 


Enables Compressed, or Normal Character 
mode for the internal printer as 
designated by the character <x>. 

<x> ACTION 


0 Disables Compressed Character 

mode 

2 Initiates Compressed Character 

mode 
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STATUS REQUESTS 


A status request is a request made by an application to the terminal for 
information about the current condition of a physical device. A status request 
is sent in the form of an escape sequence; it has to be sent from a program. 

The terminal ignores any status requests that are sent directly from the 
keyboard. Once the terminal receives a status request, it returns a string of 
characters that contains the requested information. This information is in the 
form of a data block, which is similar to data blocks that are generated in 
Block mode. The following BASIC program segment shows the operation of a 
terminal secondary status request: 

10 PRINT CHR$(27)+"~";CHR$(17); 

20 LINE INPUT A$ 

Statement 10 sends the ESC ~ sequence to request secondary status and sends the 
DC1 character to inform that it is ready to accept data. Statement 20 stores 
the information returned by the terminal in the string variable, A$. 

There are seven types of status requests: 

1. TERMINAL IDENTIFICATION. This request is the means by which your program 
determines the kind of terminal it is communicating with. 


2. TERMINAL FEATURES. There are four types of terminal-features requests: 
alphanumeric capabilities, graphics capabilities, interface capabilities, 
and the amount of Random Access Memory (RAM). 


3. PRIMARY TERMINAL STATUS. This request returns seven bytes that report the 
status of some of the mode keys (such as Caps, Remote, Block, etc.), various 
error and pending flags, and the following Terminal Configuration menu 
fields: 

XmitFnctn(A) 

SPOW(B) 

InhEolWrp(C) 

Line/Page(D) 

InhHndshk(G) 

InhDC2(H) 
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4. SECONDARY TERMINAL STATUS. This request returns seven bytes that report 
the status of the memory lock, buffer memory, and I/O firmware. 


5. DEVICE STATUS. This request returns three bytes that report the status of 
the internal printer, HPIB, and/or RS232 device. 


6 . CURSOR-POSITION SENSING. This request returns an escape sequence that 

contains the row and column in which the cursor is located. Cursor position 
sensing is described earlier in this section. 

7. COMMAND COMPLETION-STATUS. After issuing a copy line, copy page, copy 

all, advance line, or advance page sequence, the terminal automatically 
returns one character that indicates the completion status of the operation. 
The returned character indicates satisfactory completion (S), failure (F), 
or interruption of the operation (U) because the terminal operator pressed 
the [Return] key. 

The following paragraphs describe the escape sequence used for each of the above 
requests, and also the format of the returned status information. 
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Status-Transfer Handshaking 

The terminal treats all status requests as block transfers. In response to a 
status request, the terminal transmits the following items: an escape sequence, 
a series of data bytes, and a terminator. The terminator varies according to the 
mode as shown below: 

Character Mode: <CR> or <CR><LF> 

Block Line Mode: <CR> or <CR><LF> 

Block Page Mode: <Block Terminator> 

In either Character mode or Block Line mode, the terminator is <CR><LF> if Auto 
Line Feed mode is enabled. In Block Page mode, the block terminator is as 
selected on the Terminal Configuration menu. The default block terminator is 
<RS>. 

The type of handshaking used is determined by the G and H straps described in 
the section on Block Transfers. The user can also set the G and H straps from 
the keyboard, by setting the InhHndShk and Inh DC2 fields of the Terminal 
Configuration menu as shown below: 


Table 2-7. 

Setting the Handshaking 

Protocol 

InhHndshk(G) 

Inh DC2(H) 

Handshake 

No 

Yes or No 

DC1 

Yes 

Yes 

No Handshake 

Yes 

No 

DC1/DC2/DC1 


NOTE 


A status-request escape sequence resets the "block trigger 
received" flag. For example, if you are using the DC1 
handshake and the terminal receives a <DC1> followed by the 
request, the terminal "forgets" that a block trigger was just 
received; therefore, the terminal will not send the data 
immediately. The terminal will not start the data transfer 
unless it receives another <DC1>. 
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Status-Transfer Priority 

When handshaking is in effect and the terminal receives more than one status 
request, status-data transfers are constructed and sent according to the 
block-transfer-priorities shown below. Only one status transfer occurs for each 
complete handshake, although more than one may be pending. 


Priority of Block Transfers 


highest 


lowest 


Primary status (ESC A ) 

Secondary status (ESC ~) 

Device status (ESC &p <n> A ) 

Cursor sense (ESC ' or ESC a) 

Transmit user-defined softkeys (fl-f8) 

Display transfer ([ENTER] key or ESC d) 

Command completion status (S, F, or U returned) 
Terminal ID and capabilities (ESC *s A ) 


If the terminal receives more than one status request of the same type, once the 
handshaking is completed, the terminal acknowledges and responds only to the 
most recently received request. 


Terminal identification 

You request the terminal ID status by sending the following escape sequence: 

ESC * s A 

The terminal responds by sending back the following string: 

2623A 

or 

150A 

depending on the setting for "Terminal ID" in the Terminal Configuration menu. 

If you are communicating with an HP 3000, you should specify 2623A. You can 
change and save this value manually by going to the Terminal Configuration Menu. 
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Interpreting the Status 

The terminal responds to all status requests by returning an escape sequence 
followed by a string of bytes. The lower bits of each byte contains the status 
information. The upper four bits are set so that the byte translates into an 
ASCII printing character (that is, a character that has an ASCII decimal value 
from 32 through 126). For example, the format for primary, secondary, and 
device status requests is shown in the table below. Notice that the upper four 
bits of each byte are set to "0011", which limits the ASCII decimal values to a 
minimum value of 48 (for these requests), well within the range of ASCII 
printing characters. The format for terminal capabilities status bytes is 
similiar. 


Table 2-8. Returned Status Byte Format 


ASCII 

Character 


Binary 

Value 


0 

0011 

0000 

1 

0011 

0001 

2 

0011 

0010 

3 

0011 

0011 

4 

0011 

0100 

5 

0011 

0101 

6 

0011 

0110 

7 

0011 

0111 

8 

0011 

1000 

9 

0011 

1001 


0011 

1010 


0011 

1011 

< 

0011 

1100 


0011 

1101 

> 

0011 

1110 


0011 

1111 


o 
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Terminal Status 


The terminal status is indicated by 14 status bytes (0-13) that contain 
information about the display memory size, the strap settings for the 
configuration menu, and any terminal errors. These lU status bytes are 
displayed, in two groups of seven bytes each, below the system-test screen 
pattern when [SYSTEM TEST] softkey is pressed. The first seven status bytes 
(0-6) correspond to the primary terminal status, and the second seven bytes 
correspond to the secondary terminal status. 

PRIMARY TERMINAL STATUS. 

You request the first set of terminal status bytes (bytes 0-6) by sending the 
following escape sequence: 

ESC a 

The terminal responds with an ESC \, and seven status bytes followed by a 
terminator to the application. Figure 2-1 shows a typical primary 
terminal-status request and response. This example assumes that the DC1 
handshake is being used and that the appropriate terminator is a <CR>. Figure 
2-2 illustrates the function of each bit in each byte. 





Escape Sequence Programming 



BYTE ASCII 


BINARY 

0011 1111 


STATUS 

— >15K bytes of display memory 

— Function key transmission disabled 

— Space overwrite latch disabled 
—Cursor wrap around disabled 

— Strapped for line 


_ Inhibit DC2 disabled 

— Upper case only 

— Block mode 

— Auto line feed 

—Terminal sends secondary status (always 1) 


- ENTER key has been pressed 


0011 11 010— 


— No data comm errors 
-Last Self Test ok 

—No loader checksum errors (always 0) 

— No device errors 


°°?L 


- No device status or device operation status pending 


Figure 2-1• Terminal Primary Status Example 
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PRIMARY STATUS BYTES 


BYTE 0 DISPLAY MEMORY SIZE 


BYTE 2 CONFIGURATION STRAPS E-H 




BYTE 1 CONFIGURATION STRAPS A-D BYTE 3 LATCHING KEYS 




Figure 2-2. Terminal Primary Status Bytes 
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PRIMARY STATUS BYTES (cont’d) 


BYTE 4 TRANSFER PENDING FLAGS BYTE 6 DEVICE TRANSFER PENDING FLAGS 



Loevice Status Pending 
1 = yes 
0 - no 


-Device Operation Status 

Pending 
1 = yes 
0 - no 


BYTE 5 ERROR FLAGS 



Figure 2-2. 


Terminal Primatry Status Bytes 


(Continued) 
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SECONDARY TERMINAL STATUS. 

You request the second set of terminal-status bytes (bytes 7-13) by sending the 
following escape sequence: 

ESC ~ 

The terminal responds with an ESC |, and seven status bytes followed by a 
terminator. Figure 2-3 shows a typical secondary terminal status request and 
response. This example assumes that the DC1 handshake is being used and that 
the appropriate terminator is a <CR>. Figure 2-4 illustrates the function of 
each bit in each byte. 



BINARY STATUS 

0011 0000 No buffer memory installed. 


- Self Test enabled 


— Data comm self-test inhibited 


— Memory not locked 


Figure 2-3. Terminal Secondary Status Example 
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SECONDARY STATUS BYTES 


BYTE 7 BUFFER MEMORY 

a | 7 | 6 | S | 4 | 3 2 1 

0 0 1 1 0 0 0 0 

bytes 
bytes 

-4K bytes 

--8K bytes 

Memory installed in addition to display memory that is 
available for use as data buffers (Always 0). 


BYTE 9 CONFIGURATION STRAPS J-M 



1-Strap J (Auto Terminate 
1 = yes (Enabled) 

0 = no (Disabled) 

-Strap K (Clear Terminator) 

1 = yes (Enabled) 

0 » no (Disabled) 

-Strap L (Self Test Inhibit) 

1 m yes (Inhibit test) 

0 = no (Allow test) 

I-Strap M 

Strap M does not apply to the terminal. 



BYTE 8 TERMINAL FIRMWARE CONFIGURATION BYTE 10 CONFIGURATION STRAPS N-R 
(always five) 



I/O firmware installed 

No APL Firmware 

Terminal 

identifies 

self 

Non-programmable 

terminal 



Figure 2-U. Terminal Secondary Status Bytes 


2-68 


































































Escape Sequence Programming 



Figure 2-k. Terminal Secondary Status Bytes (Continued) 


TERMINAL CAPABILITIES. 

Four requests can be issued for terminal capabilities: alphanumeric, graphics, 
interface capabilities, and the amount of terminal RAM. These requests are 
generated with the following escape sequence: 

ESC *s <x> A 

where "x" selects the request type, as follows: 

Table 2-9. Terminal Capability request 

X REQUESTED INFORMATION 


-1 Alphanumeric capabilities 

-2 Graphics capabilities 

-3 Amount of Terminal RAM memory 

-1* Interface capabilities 
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The terminal responds with a string of bytes. The first byte indicates the 
number of status bytes in the response. (This byte is not included in the 
count.) The following byte or bytes contain the requested data as shown in 
(figures 2-5 through 2-9). 

If the "x" parameter is less than -4 (-5, -6, etc.), then a single byte 
indicating 0 status bytes is returned. (This byte is the character 
(OIOOOOOO).) If "x" is greater than 1 and if the terminal contains graphics, 
then the terminal returns graphics-status information. 



Figure 2-5. Terminal Capabilities (Alphanumeric- 
Typical) Status Example 
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Figure 2-6. Terminal Alphanumeric 
Status Bytes 


Capabilities 
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Figure 2-7. Terminal Graphics Capabilities Status 
Bytes 
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Figure 2-8. Installed Memory Status Bytes 
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Figure 2-9* Terminal Interface Capabilities Status 
Bytes 
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Device Status 


You can obtain information about the status of the internal printer or external 
device by issuing a device-status request. This request would typically be made 
following a print operation or after examining bytes 5 and 6 of the terminal 
status. 

You request the device-status by sending the following escape sequence: 

ESC &p <device code> A 

where <device code> is either 4 or 6. If <device code> is 6, the terminal 
returns status on the internal printer. If <device code> is 4, then the 
terminal returns information about the external device or internal printer 
depending on the setting of the PrinterCode4 field in the Terminal Configuration 
menu. The PrintCode4 field lets you choose between an external device or the 
internal printer. 

If <device code> is any value other than 4 or 6, the escape sequence is ignored- 

The terminal responds with the sequence ESC \ p<device code>, followed by three 
status bytes followed by a terminator. Figure 2-10 shows a typical device status 
request and response. 



Figure 2-10. Device Status Example 
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The device status bytes are shown in figure 2-11. 


DEVICE STATUS BYTES 
(integral printer) 


DEVICE STATUS BYTES 
(external printer) 


BYTEO 



•out of paper or 
printer gate open 


BYTEO 



BYTE 1 


BYTE 1 



0 


Printer Busy 
Printer not Busy 


•Command Execution 
1 = last command 
performed 
0 = last command 
interrupted 



BYTE 2 



-Printer Present 


1 - yes 
0 - no 


1 


L-printer Connected 
1 - yes 
0 - no 


Figure 2-11. 


Device Status Bytes 
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SECTION 


ALPHA/GRAPHICS I/O SUBSYSTEM 


INTRODUCTION 



The Alphanumeric and Graphics Input/Output Subsystem (AGIOS) is a set of system 
functions that lets you access the alphanumeric and graphics intrinsics of the 
HP 150. These function calls let you perform text and graphics mode operations 
on your display, let you control your keyboard, let you define and use 
application softkeys, and let you perform all touchscreen operations. 

AGIOS provides an efficient and rapid way of accessing terminal features that is 
five times faster than using comparable escape sequences. In addition, AGIOS 
provides functions such as transferring a block of data and enhancements to the 
display, defining application softkeys, intercepting keystrokes, and defining 
characters in Graphics Text mode, which can not be done with escape sequences. 

AGIOS can best be programmed with Intel 8086/8088 assembly language. If you 
must access AGIOS functions from a high-level language, such as BASIC or Pascal, 
you may have to link an assembly module which has the desired AGIOS functions 
and a high-level language module which calls the assembly functions. (See 
Appendix B on AGIOS Function Calls from High-Level Languages for more 
information.) 

You caui access each AGIOS function by performing the following steps: 

1. Select the desired function 

2. Supply the required input parameters 

3. Invoke AGIOS by issuing a software interrupt 
U. Check the completion code returned by AGIOS 

You might at first think that AGIOS functions are cumbersome to use. But you 
can write a general routine to set up all the common parameters that AGIOS 
requires to execute a function. Whenever you are ready to make a call to AGIOS, 
you set up those parameters that are unique to the particular function. Then 
you can call the general routine to handle the rest of the routine work of 
calling AGIOS for you. 

When using AGIOS functions, there is one thing you should remember. The I/O 
subsystem does not perform any error checking on input parameters. These 
functions assume that all input parameters given are valid. Therefore, before 
calling AGIOS, you should check that all input parameters to the I/O subsystem 
are legal. (There are examples throughout the AGIOS sections that show you how 
to use AGIOS functions.) 
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The alphanumeric functions are listed in the order of function number in the 
Alphanumeric Input/Output Subsystem (AIOS) section. The graphics functions are 
listed in the order of function number in the Graphics Input/Output Subsystem 
(GIOS) section. For each AGIOS function, there are detailed descriptions of 
input parameters, output status, and additional remarks. 

Where applicable, the AGIOS call name is followed by the corresponding escape 
sequence. For example, 

DEFINE TOUCH FIELD (ESC - z g) 

This indicates that the escape sequence which corresponds to the Define Touch 
Field AGIOS call is ESC - z g. Additional parameters may be required. (See the 
section on Escape Sequence Programming for the exact syntax.) 

In the video intrinsics subsection, a sample assembly program segment is 
included with a few selected functions to illustrate the use of these functions. 
Once you understand those sample program segments, calling any AGIOS functions 
should be straight forward. Some additional Pascal callable video intrinsics 
examples are included in Appendix C. You will also find a quick reference on 
AGIOS functions and equivalent escape sequences in Appendix A. 
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HOW TO USE AGIOS FUNCTION CALLS 


You access AGIOS calls via MS-DOS system function 44 hex. An AGIOS call is an 
"I/O Control Write" on the console device. (See the Microsoft Programmer's 
Reference Manual on system function 44 hex). 

In general, the parameters of each AGIOS function are passed in a buffer in the 
order specified in each function’s description. 

For each function, the first parameter is a 2-byte function code. The high byte 
is the index number (0 = AIOS, 4 = GIOS); the low byte is the function number. 
The function code is given in decimal . 

If additional parameters are required, they will be specified after the function 
code. Your application has to build a buffer with the required parameters 
stored in the order that they are listed in each function’s description. The 
address (segment and offset) of this input buffer is then passed to the AGIOS 
function. 

Each AGIOS function is initiated by setting up proper Intel 8088 registers and 
then issuing an interrupt to the operating system (INT 21H). 

The 8088 registers should be set up as follows: 

AX = I/O Control Write (4403H) 

BX = Console device handle (1) 

CX = Number of bytes in buffer 
DS = Buffer segment address 
DX = Buffer offset address 

Upon return from an AGIOS function, the AX register contains the completion 
status. A zero value in AX indicates the function was successful; otherwise, 
the function was not successful. Your application should always examine the AX 
register after each AGIOS call for the completion status. 


NOTE 


AIOS function call (0,25) in Operating System version B.01.00 
and later returns an address that you can call to execute AGIOS 
functions instead of using system function 44 hex. Calling 
this address eliminates the MS-DOS system function overhead; 
therefore, AGIOS functions are executed faster. (See function 
(0,25) in the section on Alphanumeric Subsystem Function 
Reference for detailed information.) 
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AN EXAMPLE ON CALLING AN AGIOS FUNCTION 


The following example shows how you use AGIOS function calls in assembly 
language. The function call is the Execute Two-Character Sequence, which is 
used here to clear the display screen. This AGIOS function call requires a 
three-byte buffer that contains the function code followed by the "J" parameter: 


BUFF | 

16 

1 0 | 

J 

1 


Byte: 

+0 

+1 

+2 



A sample assembly program segment 

calling the AIOS function to 

clear the display 

is listed below: 





CLRSCRN: 

MOV 

AX,UU03H 


;I/0 control write 



MOV 

BX,1 


;console handle, always = 1 



MOV 

CX,3 


;BUFF Length = 3 



MOV 

DX,OFFSET 

BUFF 

;BUFF offset address 






;segment address is already 

in DS 


INT 

21H 


;execute the function 



RET 



;return 


BUFF 

DB 

16,0,’J’ 


;BUFF content 



In the above example, BUFF data segment is assumed to have already been assigned 
to DS. 

A ’clear display’ operation can be accomplished with a simple ’PRINT CHR$(27) + 
"J"’ statement in BASIC or a similar print statement in other languages. 

However, the AGIOS call executes the ’clear display’ function faster. Moreover, 
the AGIOS function you want to execute may not have am equivalent escape 
sequence associated with it. 

As a result, you will want to use AGIOS functions in applications that require a 
faster and more efficient method of programmatically controlling the HP 150 
system. 
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SYNTAX USED IN AGIOS FUNCTION CALLS 


Each AGIOS function call is explained in detail in the sections on AGIOS 
function reference. Each function requires a number input parameters stored in 
a buffer to be passed to the function. In order to clarify the parameters your 
application needs to supply, a standard notation is used in the function 
reference sections. Before you try to use these AGIOS functions, you should 
understand the syntax used. 

One simple method to set up parameters and pass them in a buffer is to define 
them using Microsoft Macro Assembler directives DB (Define Byte), DW (Define 
Word), or DD (Define Double Word). These directives are discussed in the 
Microsoft Macro Assembler Manual. 


Parentheses, positional notation, and possible implementation of assembler 
directives are used as follows: 


PARM 

Indicates a single byte (8 bit) 
parameter. 

DB 

PARM 

(PARM1,PARM2) 

Indicates two single byte param¬ 
eters with parml in the high 
byte and parm2 in the low byte. 

DB 

PARM2,PARM1 

(,PARM) 

Indicates a single byte param¬ 
eter in the low byte of the 
word. The high byte is ignored. 

DB 

PARM,0 

(PARM,) 

Indicates a single byte param¬ 
eter in the high byte of the 
word. The low byte is ignored. 

DB 

0,PARM 

(PARM) 

Indicates a word (l6 bit) param¬ 
eter. 

DW 

PARM 

((PARM)) 

Indicates a double word (32 bit) 
parameter. Usually the low word 
is a data offset address and the 
high word is a segment address. 

DD 

PARM 


If ((PARM)) is used as a 32-bit address, you 
Word (DW) assembler directive: 


could define it using the Define 


DW PARM_OFFSET,PARM_SEGMENT 

In the above instruction, PARM_OFFSET is the 16-bit offset address and 
PARM_SEGMENT is the l6-bit segment address. 
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NOTE 1 


If a variable is defined as a word, the two bytes are stored 
in memory backward; that is, the least significant byte (or 
low byte) is stored in memory before the most significant 
byte (or high byte). 
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SECTION 


ALPHANUMERIC INPUT/OUTPUT 
SUBSYSTEM FUNCTION REFERENCE 



INTRODUCTION 



THI - EL 


j 


This section lists functions in the Alphanumeric Input and Output Subsystem 
(AIOS) in numerical order according to the function number. If you do not 
already know the procedure for calling Alphanumeric/Graphics Input/Output 
Subsystem (AGIOS) functions and are not familiar with parentheses and positional 
notations used in the function reference, you should read Section 3 on AGIOS 
first. 


AIOS FUNCTIONS 


Each AIOS function is identified by a l6-bit function code as shown below: 
Bit 15 0 


I 0 | X | 


high low 

byte byte 

For AIOS functions, the high byte of the function code is always 0. The low 
byte (X) is the function number. The function code must be the first parameter 
stored in the input buffer. 

In this section, an AIOS function code is given in decimal and is represented by 
an ordered-pair (0,X). You should note that the Intel processor interprets the 
two bytes in a word in reverse order. That is, in memory, the value X is stored 
before the value 0. 

There are two ways of defining a function code. You cam define a function code 
either in byte-mode or in word-mode using Microsoft Macro Assembler directives 
Define Byte (DB) or Define Word (DW). 

For example, to allocate a buffer called IN_BUF and store the function code 
(0,1) in the first word of IN_BUF, you can use either one of the following 
instructions: 

In Byte-mode: IN_BUF DB 1,0 

In Word-mode: IN BUF DW 1H 
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AIOS Function Reference 


AIOS lets you programmatically control the following alphanumeric functions 


o Video 

o Application Softkeys 
o Keyboard and Display Control 
o Touchscreen 
o Keyboard Processing 
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BATCH FUNCTION CALL 


A special function call is available which lets you execute a sequence of 
function calls automatically. Using this function call is especially convenient 
when you frequently perform the same set of AGIOS function calls. 

To "batch" function calls, you set up the sequence of AGIOS function calls in a 
corrmand buffer. Then you issue the following batch function call using the 
command buffer as one of its parameters. 

Input Buffer : 

( 0 , 0 ) 

(BUFFER-LENGTH) 

((COMMAND-BUFFER)) 


Output Status: 

AX = 0 
AX <> 0 

Remarks : 

A batch call is aborted when any of the function calls in the command buffer 
causes an error condition, but any functions specified before the error function 
will be executed. Additionally, you cannot nest batch function calls; that is, 
you cannot include this function in the command buffer. 

Example : 

This example clears the alpha display by homeing up first, then clearing the 
display. Refer to the ’H’ and ’J’ options of the "Execute Two-Character 
Sequence" function call (0,l6) in this section. 

The command buffer looks like this: 


Function code 

The number of bytes in the command buffer 

Segment and offset address of the buffer containing the 
AGIOS function calls. The function calls are defined 
consecutively. Each function’s parameter format is the 
same as specified for the individual function call. 

First word = Command buffer offset address 
Second word = Command buffer segment address 


Successful 

Unsuccessful 


Contents --> | 1 6 


Byte 


+0 


16 | 0 


+2 


+U +5 
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The assembly routine that sets up the command buffer and executes a batch 


call might look like this: 


CLS: 

MOV 

AX,CS 


MOV 

DS ,AX 


MOV 

CMDSEG,AX 


MOV 

AX,UU03H 


MOV 

BX,1 


MOV 

CX,8 


MOV 

DX,OFFSET BATCH 


INT 

21H 


RET 


CMDBUF 

DB 

16 , 0 ,’H\l 6 , 0 ,’. 

BATCH 

DB 

0,0 

BUFLEN 

DW 

6 

CMDOFF 

DW 

CMDBUF 

CMDSEG 

DW 

•> 


assign data segment to be 
the same as the code segment 
and store it in input buffer 

I/O control write 
console handle 
input buffer length 
input buffer offset address 


command buffer content 
batch command function code 
command buffer length 
command buffer offset 
command buffer segment 
(value to be assigned) 
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VIDEO INTRINSICS 


The video intrinsics are a set of functions that can be used to manipulate the 
information (characters, enhancements, and character sets) displayed on the 
screen. 

This section gives the AIOS function calls that support the video portion of the 
HP 150 system. The following video functions are explained in detail in this 
section. 


Function Code 

( 0 , 1 ) 

( 0 , 2 ) 

(0,3) 

(0,4) 

(0,5) 

( 0 , 6 ) 

(0,7) 


Function 

Define Area 
Write Area 
Clear Area 
Enhance Area 
Read Area 
Shift Area 
Write Line 


With the exception of the Write Line function, all video intrinsics operate on a 
defined area of the display. The total size of the display is 48 rows by 80 
columns. However, only 24 of the rows are visible on the screen at any given 
time. The rows are numbered from 0 through 47; the columns are numbered from 0 
through 79- 


A defined area can be from 1 to 48 rows high, and from 1 to 80 columns wide. 

That is, the defined area can be as small as one character (one row high and one 
column wide) or as large as the entire display (48 rows high and 80 columns 
wide). 


The speed of the video intrinsics varies directly with the size of the defined 
area. The larger the area, the faster the video intrinsics operate. You will 
obtain the most efficient performance from the video intrinsics if your defined 
area is as large as is practical for your application. 

There is a one-to-one correspondence between the position of a data byte in its 
buffer and the character position that it will affect in the defined area, 
starting at the upper left corner of the defined area, incrementing column 
position first and then row position. 

The character data consists of the 8 bit extended ASCII character code 
(Roman-8). 
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The HP 150 has four different display enhancements. Characters can appear in 
the following ways, or in any combination of them: 


o Half-bright 
o Underline 
o Inverse 
o Blinking 


The following table shows the different combinations of display enhancements and 
enhancement codes. The enhancements range from (UOH) to (5FH). A space 
(20H) indicates that the currently active enhancement is used. 


Display Enhancements Table 

Security off: |@ABCDEFGHIJKLMNO 

Security on: |PQRSTUVWXYZ[\] 


Half-Bright 
Underline 
Inverse Video | 
Blinking 
No Enhancement | 


XXX 
XX X 

XXX 
X 


X X X X X 
X X 

X XX 

XXX 


the enhancement is 


XXX 
XXX 
X X 
X X 


displayed, but the 


listed below: 


If a "security on" enhancement is used, 
character is hidden. 

The character set and the code associated with each set is 


Code 


Character Set 


% 

A 

B 

C 

D 

SPACE 


Normal Roman 
Line Drawing 
Bold Face Roman 
Italic Roman 
Math 

The current character set 


As described in the Escape Sequences section, the ESC ) <cset> sequence can be 
used to select alternate character set. However, this escape sequence only 
allows you to select the Normal Roman, Math, and Line sets. In order to use 
Bold Face and Italic sets, you have to use video intrinsics in AGIOS. 


NOTE 


A null data buffer pointer (segment = OFFFFH) will suppress the 
update operation for that data type. 
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Define Area 

This function specifies the area to be operated upon by subsequent video 
intrinsics. 


Input Buffer ; 

( 0 , 1 ) 

(LR-ROW,LR-COL) 


(UL-R0W,UL-C0L) 


((PREV-COORD)) 


Function Code. 

Defines the lower right corner of the defined area. 

LR-ROW = Lower right row (0-47) 

LR-COL = Lower right column (0-79) 

Defines the upper left corner of the defined area. 

UL-ROW = Upper left row (0-47) 

UL-COL = Upper left column (0-79) 

A double-word pointer to a buffer where the previous 
defined area coordinates are returned. 


First word = Buffer offset adddress 
Second word = Buffer segment address 

If this pointer is null (segment = 0FFFFH), then these 
coordinates will not be returned. 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

PREV-COORD The coordinates are returned in four consecutive bytes: 

lower right column, lower right row, upper left column, 
upper left row. 


Remarks : 

You should call this function before calling any of the other video intrinsics 
functions, with the exception of the Write Line function. You can use this 
function at any time to change the defined area. Once you have defined an area, 
you need not call this function again unless you want to change the size or the 
location of the defined area. 


Note that the speed of the video intrinsics varies directly with the size of the 
defined area. The larger the defined area, the faster the video intrinsics 
operate. 


4-7 









AIOS Function Reference 


Example : 


This example defines a rectangular area from column 10 to column lU and from row 
15 to row 16 . 


0 


79 


0 


47 


10 14 


151 

161 


Function Code = (0,1) 
(LR-ROW,LR-COL) = (l6,lU) 
(UL-R0W,UL-C0L) = (15,10) 
((PREV-COORD)) = ((-1)) 


The following is a sample assembly program segment which calls the Define Area 
function to define such an area: 

; Build the input buffer with the specified parameters. 


IN BUF DW 

1 

;function code 

DB 

lU 

;lower right column 

DB 

16 

;lower right row 

DB 

10 

;upper left column 

DB 

15 

;upper left row 

DW 

0FFFFH 

;don’t return 

DW 

0FFFFH 

;previous coordinates 

; Set up registers for AGIOS call. 

; DS register 

is assumed to be the buffer’s data segment. 

EUNICE: MOV 

AX,U403H 

;I/0 control write 

MOV 

BX,1 

;console handle 

MOV 

CX,10 

;buffer length 

MOV 

DX,OFFSET IN BUF 

;buffer offset address 

I NT 

21H 

;call Define Area 

RET 


;return 

See a Pascal- 

callable example of 

this function in Appendix C 
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Write Area 

Three items of display information are associated with each character cell in 
the display. These items are the character itself, the enhancement (if any), 
and the character set. 


The Write Area function uses the data in three buffers to update the display 
information. There is a one-to-one correspondence between the position of the 
data byte in each buffer and the affected character-cell position in the defined 
area on the screen. The first byte in each buffer corresponds to the upper 
left-hand corner of the defined area. The information in this buffer increments 
the column positions first, and then increments the row positions. 


Input Buffer : 


(0,2) Function Code. 

(DATA LENGTH) Length of the data buffers. 

((ENH POINTER)) A double-word pointer to a buffer of enhancement codes 

to map to character cells in the defined area. 

First word = Buffer offset address 
Second word = Buffer segment address 


Display Enhancements Table 


Security off: 

1 

e 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Security on : 

1 

p 

Q 

R 

s 

T 

U 

V 

W 

X 

Y 

Z 

[ 

\ 

] 


- 

Half-Bright 

1 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 

1 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 

1 



X 

X 



X 

X 



X 

X 



X 

X 

Blinking 

No Enhancement 

1 

1 

X 

X 


X 


X 


X 


X 


X 


X 


X 


If this pointer is null (segment=OFFFFH), 
the enhancements are not changed. 
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((CHAR SET POINTER)) A double-word pointer to a buffer of character 
set codes to map to character cells in the 
defined area. 


((CHAR POINTER)) 


Outputs : 

AX = 0 
AX <> 0 


First word = Buffer offset address 
Second word = Buffer segment address 


Code 


Character Set 


e 

A 

B 

C 

D 

SPACE 


Normal Roman 
Line Drawing 
Bold Face Roman 
Italic Roman 
Math 

The current character set 


If this pointer is null (segment=OFFFFH), 
then the character sets are not changed. 

A double-word pointer to the buffer of character 
data to map to character cells in the defined area. 

First Word = Buffer offset address 
Second Word = Buffer segment address 

If this pointer is null (segment=OFFFFH), 
then the characters are not changed. 


Successful 

Unsuccessful 


Remarks ; 

Before you use this function, you must use the Define Area function 
(0,1) to define the display area first. 

If you want to specify one enhancement for the entire defined area, 
you should use the Enhance Area function (0,4). Otherwise, the system’s 
performance will be slowed because of the time that the system needs 
to process the enhancement buffer. 

If all Write Area functions in your application use no enhancement 
and Normal Roman character set, you can use the Clear Area function 
to initialize the defined area. You can then set ENH POINTER and 
CHAR SET POINTER to null (segment = OFFFFH) for all the Write Area 
functions in your application. 

*««*«** See ^ exam pi e 0 f this function on the next page ******* 
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Example : 

This example assumes that the defined area has already been defined. 

(See the example in the Define Area function (0,1).) This example calls 
the Write Area function to write ’HELLO THERE’ in inverse blinking 
in the defined area. 

10 11 12 13 Ik 

15 I H E L L 0| Function Code = (0,2) 

16 j T H E R E| (DATA LENGTH) = (10) 

- (( ENH POINTER)) = 32-bit pointer 

((CHAR SET POINTER)) = ((-1)) 

((CHAR POINTER)) = 32-bit pointer 

The following is a sample assembly program segment which sets up the above input 
parameters and calls Write Area to write the data into the defined area. The 
enhancement and character buffers’ segment addresses are assumed to be the same 
as the current data segment address. 

; Build the input buffer 


IN_BUF 

DW 

2 

;function code 


DW 

10 

;data buffers length 


DW 

ENH PTR 

;enhancement offset 

SEG1 

DW 

? 

;segment to be assigned later 


DW 

-1 

;character set 


DW 

-1 

;does not change 


DW 

CHAR_PTR 

;character offset address 

SEG2 

DW 

7 

;segment to be assigned later 

ENH_PTR 

DB 

’ccccc’ 

;enhancement buffer 


DB 

’ccccc’ 

;inverse blinking = C 

CHAR_PTR 

DB 

’HELLO’ 

;character 


DB 

’THERE’ 

; buffer 


; Set up registers for AGIOS call. 

; DS register is assumed to be the buffer’s data segment. 

MOV AX,DS ;get current data segment address 

MOV SEG1,AX ;assume buffer segment address 

MOV SEG2,AX ; is the same as data segment address 

MOV AX,4L03H ;I/O Control Write 

MOV BX,1 ;console handle 

MOV CX,16 ;input buffer length 

MOV DX,OFFSET IN_BUF ;buffer offset address 

INT 21H ;call Write Area 

RET ;return 

See a Pascal-callable example of this function in Appendix C. 
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Clear Area 

This function clears a defined display area to ASCII blanks (20H), no 
enhancements, and Normal Roman character set. 

Input Buffer : 

(0,3) Function Code 

Outputs : 

AX = 0 Successful 

AX = <> 0 Unsuccessful 


Remarks: 

Before you use this function, you must use the Define Area function (0,1) to 
define a display area first. 

See a Pascal-callable example of this function in Appendix C. 
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Enhance Area 


This function sets the specified enhancement to the entire defined display area. 
Input Buffer : 

(0,4) Function Code. 

(ENHANCEMENT) An enhancement code from (UOH) through 

(5FH) (The high byte is a "don’t care".) 

Display Enhancements Table 

Security off: |@ABCDEFGHI JKLMNO 
Security on:|PQRSTUVWXYZ[\] 


Half-Bright | 

Underline | 

Inverse Video | X X 

Blinking j X X 

No Enhancement | X 


X 


X X 

XXX 
X X 

XXX 


X X X X X X 
X X X X 
XX XX 

XXX 


Outputs : 

AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks: 


Before you use this function, you must use the Defined Area function 
define a display area first. 


( 0 , 1 ) 


to 


This function does not affect characters and character sets already in the 
defined area. If you choose to use the "security" enhancements, then the 
characters in the defined area will not be displayed until you turn off 
security. 


See a Pascal-callable example of this function in Appendix C. 
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Read Area 

Three items of display information are associated with each character cell in 
the display. These items are the character itself, the enhancement (if any), 
and the character set. The Read Area function reads the display information, 
and returns it in three buffers. This function fills each buffer with the 
applicable information, which it reads from right to left across the defined 
area (one row at a time, starting with top row in the defined area). 


Input Buffer : 


(0,5) 


Function Code 


(DATA LENGTH) Length of the data buffers. 

((ENH POINTER)) A double-word pointer to the buffer that the 

enhancements data will be returned. 


First word = Buffer offset address 
Second word = Buffer segment address 

Display Enhancements Table 


Security off: 

1 

e 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Security on : 

1 

p 

Q 

R 

s 

T 

U 

V 

W 

X 

Y 

z 

[ 

\ 

] 


- 

Half-Bright 

1 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 

1 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 

1 



X 

X 



X 

X 



X 

X 



X 

X 

Blinking 

No Enhancement 

1 

1 

X 

X 


X 


X 


X 


X 


X 


X 


X 


If this pointer is null (segment=OFFFFH), then 
the enhancements are not returned. 


((CHAR SET POINTER)) A double-word pointer to a buffer that the 
character sets will be returned. 


First word = Buffer offset address 
Second word = Buffer segment address 


Code 


Character Set 


e 

A 

B 

C 

D 


Normal Roman 
Line Drawing 
Bold Face Roman 
Italic Roman 
Math 


If this pointer is null (segment=OFFFFH), then 
the character sets are not returned. 
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((ASCII POINTER)) A double-word pointer to the buffer that the character 
data will be returned. 

First word = Buffer offset address 
Second word = Buffer segment address 

If this pointer is null (segment=OFFFFH), then the 
character data is not returned. 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


ENH The buffer of enhancements in the defined area 

CHAR SET The buffer of character set codes in the defined area 

ASCII The buffer of character data in the defined area 

Remarks: 


Before you use this function, you must use the Defined Area function (0,1) to 
define a display area first. 


This function will return the number of bytes specified in DATA LENGTH 
regardless of the actual size of data buffers. However, if DATA LENGTH is 
greater than the number of character cells in the defined area, then only the 
data in the defined area is read. 

See a Pascal-callable example of this function in Appendix C. 
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Shift Area 

This function shifts the characters, enhancements, and character sets in the 
defined area by a specified number of rows or columns. This function also lets 
you assign display information for the area vacated by the action of shifting 
the data in the defined area. 

Input Buffer : 


(0,6) 


Function Code 

(DATA 

LENGTH) 

Length of the data buffers. 

((ENH 

POINTER)) 

A double-word pointer to a buffer of enhancements to map 
to character cells in the vacated area. 



First word = Buffer offset address 

Second word = Buffer segment address 


Display Enhancements Table 

Security off: |@ABCDEFGHI JKLMNO 
Security on: |PQRSTUVWXYZ[\] 


Half-Bright | XXXXXXXX 

Underline | XXXX XXXX 

Inverse Video j XX XX XX XX 

Blinking |XXXXXXXX 

No Enhancement | X 

If this pointer is null (segment=OFFFFH), then 
the vacated area’s enhancements will not 
be altered. 

((CHAR SET POINTER)) A double-word pointer to a buffer of character 
sets to map to character cells in the 
vacated area. 

First word = Buffer offfset address 
Second word = Buffer segment address 


Code 


Character Set 


A 

B 

C 

D 

SPACE 


Normal Roman 
Line Drawing 
Bold Face Roman 
Italic Roman 
Math 

The current character set 


4-16 








AIOS Function 


Reference 


If this pointer is null (segment=0FFFFH), then 
the character sets in the vacated area will not. 
be changed. 

((CHAR POINTER)) A double-word pointer to a buffer of characters 
to map to the vacated area. 

First word = Buffer offset address 
Second word = Buffer segment address 

If this pointer is null (segment=OFFFFH), the 
characters in the vacated area will be set to blanks. 

(DIRECTION,DIST) DIRECTION: The direction in which the data 

in the defined area is to be shifted. 


0 = up 

1 = down 

2 = left 

3 = right 

DIST: The number of rows or columns to shift 
the current video data. 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks : 

Before you use this function, you must use the Defined Area function (0,1) to 
define a display area first. 


This function does not change the position of the defined area. Just the data 
in the defined area is shifted, leaving a vacated area in the defined area. 

The ASCII data in the defined area is shifted by a specified number of rows or 
columns. The vacated area is replaced with ASCII blanks. However, the 
enhancements and character sets are copied instead. As a result, you can choose 
to leave the data in the vacated area unchanged or you can assign new data to 
the vacated area. If you do not want to change the data in the vacated area, 
you will have to set ENH POINTER or CHAR SET POINTER to null (segment = OFFFFH). 

Any data shifted off an edge of the defined area is lost. This function does 
not affect any data that is outside of the defined area. 


If DATA LENGTH is greater than the number of character cells actually needed to 
fill the vacated area, this function uses only those bytes that are necessary to 
fill the vacated area. If DATA LENGTH is less, then only the number of 
character cells specified in DATA LENGTH will be changed. 
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Example : 

This example assumes that the defined area has already been defined and data has 
already been written by Define Area and Write Area functions, respectively. 

(See examples in Define Area (0,1) and Write Area (0,2)). This example shifts 
the data in the define area one row down. The vacated area does not get 
updated. 


Before the shift: 



10 

Characters 

11 12 13 1U 


Enhancements 

10 11 12 13 lU 


Character 
10 11 12 

Sets 

13 1U 

15 

1 H 

E 

L L 0 | 

15 

| c c c c c I 

15 

I % % 

% 

% € 1 

16 

1 T 

H 

E R E | 

16 

I c c c c c 1 

16 

1 % % 

% 

e % i 

After the 

shift: 









Characters 


Enhancements 


Character 

■ Sets 


10 

11 

12 13 lU 


10 11 12 13 lU 


10 11 

12 

13 1U 

15 

1 


1 

15 

| c c c c c | 

15 

1 @ @ 

% 

e e 1 

16 

1 H 

E 

L L 0 | 

16 

I c c c c c | 

16 

I 6 % 

% 

% % i 


Note that after the shift, enhancements and character sets do not change in the 
vacated area (row 15); ASCII data is changed to blanks. 


; Build the 

input parameter buffer with the specified input parameters 

IN BUF DW 

6 

;function code 

DW 

0 

;data buffer length 

DW 

0FFFFH,0FFFFH 

;enhancement pointer = null 

DW 

0FFFFH,0FFFFH 

;character set pointer = null 

DW 

0FFFFH,0FFFFH 

;character pointer = null 

DB 

1 

;shift 1 row 

DB 

1 

;direction = down 


; Set up registers to call AGIOS 

; DS register is assumed to be the buffer’s data segment 


MOV 

AX,UU03H 

;I/0 control write 

MOV 

BX,1 

;console handle 

MOV 

CX,l8 

;input buffer length 

MOV 

DX,OFFSET IN BUF 

;buffer offset address 

INT 

21H 

;call shift area 

RET 


;return 


See a Pascal-callable example of this function in Appendix C. 
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Write Line 

This function writes a single row (or part of a row) anywhere in the display. 
The data is specified by three buffers. Each byte in a buffer corresponds to 
the respective display information for a character cell in the write line. 
Unlike the Write Area function, this intrinsic ignores the area bounds set by 
the Define Area function. 


Input Buffer : 


(0,7) 


Function Code 


(ROW,COLUMN) 


(DATA LENGTH) 

((ENH POINTER)) 


Defines the row and column to display the first 
character. 

Row =0-1*7 
Column =0-79 

Length of data buffers. 

A double-word pointer to the buffer of enhancements to 
be written at the designated write line. 

First word = Buffer offset address 
Second word = Buffer segment address 


Display Enhancements Table 

Security off: |@ABCDEFGHIJKLMNO 

Security on: |PQRbTUVWXYZ[\J 


Half-Bright 
Underline 
Inverse Video 
Blinking 
No Enhancement 

If this pointer is null (segment=OFFFFH), then 
the enhancements are not changed. 


X X 


I X 


X X 
X 


X X X X 


X X 
X 
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((CHAR SET POINTER)) A double-word pointer to a buffer of character 
sets to be written at the designated write line. 

First word = Buffer offset address 
Second word = Buffer segment address 

Code Character Set 

@ Normal Roman 

A Line Drawing 

B Bold Face Roman 

C Italic Roman 

D Math 

SPACE The current character set 

If this pointer is null (segment=OFFFFH), then the 
character sets are not changed. 

((CHAR POINTER)) A double-word pointer to the buffer of characters to be 
written at the designated write line. 

First word = Buffer offset address 
Second word = Buffer segment address 

If this pointer is null (segment=0FFFFH), then the 
characters are not changed. 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

This function does not require the prior definition of an area. 

If the position and length of the data violate the display boundaries, that 
portion of the data exceeding the boundary is ignored. No line wrap occurs. 

If the requested row is not currently displayed on the screen at the time of the 
request, the Line function will still be performed. When that row is 
displayed, the written data will be visible. 

Example : 

See a Pascal-callable example of this function in Appendix C. 
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APPLICATION SOFTKEYS 


The HP 150 system has three types of softkeys: system softkeys, user-defined 
softkeys, and application softkeys. System softkeys are maintained by the 
system. These keys allow access to terminal features; it is not possible for an 
application to monitor or use system softkeys. However most of the 
functionalities are accessible via escape sequences or via other AIOS functions. 
User-defined softkeys are intended to be used by the operator entering data 
directly from the keyboard. Although user-defined softkeys are not intended to 
be used by applications, many applications on the HP 3000 system use them for 
application purposes. The application softkeys on the HP 150 are designed to be 
used and interpreted by applications. 


One thing you should note is that the softkeys (and touch labels) are active 
regardless of whether or not the labels are visible on the screen. 


This section gives the AIOS function calls that support the application 
softkeys. The following application softkey functions are explained in detail 
in this section. 


Function Code 


Function 


( 0 , 8 ) 

(0,9) 

( 0 , 10 ) 

( 0 , 11 ) 

(0,12) - (0,15) 


Update Softkey Label 
Read Softkey Label 
Not used 

Display Softkey Labels 
Not used 


Application softkey functions in this section are used to manipulate softkey 
labels only. You should note that only the first eight application softkey 
labels can be displayed on the screen, the other four softkeys do not have 
labels. 


The response string for an application softkey is a keycode. Keycodes 0 - B hex 
are designated for the 12 application softkeys, respectively. It is the 
application’s responsibility to read the keycode, interpret the meaning of the 
keycode, and execute the keycode function accordingly. 

In order to read the application softkeys, your application must be in keyboard 
intercept mode. That is, your application should turn on Raw mode (MS-DOS 
function 44H), turn on Keycode mode (AIOS function (0,43)), and define the 
application softkeys to be intercepted (AIOS function (0,40)). If your 
application is not in keyboard intercept mode, then the HP 150 system will 
ignore the keycode whenever an application softkey is pressed. 

When in keyboard intercept mode, the keycode is returned to your application 
without any interpretation by the system. Your application should set up to 
read 4 bytes of information for each keyboard input. These 4 bytes give two 
bytes of key qualifier and two bytes of data. Key qualifier bytes and data 
bytes are explained in the Keycode mode section. 
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Update Softkey Label 

This function changes an application softkey label and enhancement. 


Input Buffer : 
( 0 , 8 ) 

(,NUMBER) 

((DATA)) 


(,T0P ENH) 
(,B0T ENH) 


Function Code. 

Application softkey number (the softkey number is from 1 
to 8 inclusive) (The high byte is a "don’t care".) 

A double-word pointer to a l6-byte buffer of ASCII data 
to be written into the label area. The first 8 bytes 
will be displayed on the top line; the next 8 bytes will 
be displayed on the bottom line. 

First word = Buffer offset address 
Second word = Buffer segment address 

Enhancement code for the top half of the label. (The 
high byte is a "don’t care".) 

Enhancement code for the bottom half of the label. (The 
high byte is a "don’t care".) 

Display Enhancements Table 


Security off: 

1 

% 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Security on : 

1 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 

z 

t 

\ 

] 


- 

Half-Bright 

1 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 

1 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 

1 



X 

X 



X 

X 



X 

X 



X 

X 

Blinking 

No Enhancement 

1 

1 

X 

X 


X 


X 


X 


X 


X 


X 


X 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

You can only change application softkey labels 1-8 because the other four 
softkeys do not have labels. 

The double-word pointer, DATA, cannot be null. This function just updates the 
softkey labels; it does not display the labels if they are not already 
displayed. 

To improve performance, you can use the batch function (0,0) to update all eight 
keys at once. 
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Read Softkey Label 


This function gets the application softkey number specified by the caller and 
then returns the softkey label and the enhancement code in two buffers. 


Input Buffer : 

(0,9) 

(,NUMBER) 

((DATA)) 


((ENHANCEMENTS)) 


Outputs : 

AX = 0 
AX <> 0 

DATA 

ENHANCEMENTS 


Function Code 

Application Softkey Number (The high byte is a "don’t 
care".) 

A double-word pointer to a l6-byte buffer which will 
receive the ASCII data of the label. 

First word = Buffer offset address 
Second word = Buffer segment address 

If this pointer is null (segment=OFFFFH), then the label 
characters will not be returned. 

A double-word pointer to a 4-byte buffer which will 
receive the enhancement codes. 

First word = Buffer offset address 
Second word = Buffer segment address 

If this pointer is null (segment=0FFFFH), then the 
enhancements will not be returned. 


Successful 

Unsuccessful 

The buffer has 16 bytes. The first 8 bytes are the top 
line label; the next 8 bytes are the bottom line label. 

The buffer has 4 bytes: 

First byte = Top line enhancement code 
Second byte = Don’t care 
Third byte = Bottom line enhancement code 
Fourth byte = Don’t care 
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Display Softkey Labels 

This function displays the application softkey labels in the softkey window. 
Input Buffer ; 

(0,11) Function Code 

Outputs ; 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

Once the softkey labels are displayed, pressing the function keys [fl] through 
[fl2] generates the associated keycode. (Remember, only softkey labels 1 
through 8 are visible when application softkeys are displayed; labels 9 through 
12 are not visible.) However, you cannot assume that the softkeys are disabled 
even if they are not displayed. 

Hidden softkeys are still "alive". That is, even though the labels are not 
visible on the screen, touching or pressing the function keys generates the 
keycode. 
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CONTROL FUNCTIONS 


There are AIOS functions that let your application execute many of the terminal 
and display operations which are normally done with escape sequences. You may 
prefer to use these AIOS functions instead of sending escape sequences because 
these functions execute terminal operations much faster. In many cases, they 
are up to 5 times faster. However, if you are not programming with assembly 
language and terminal performance is not a concern, then sending escape 
sequences may be more desirable. 

This section gives the AGIOS function calls that control the terminal of the HP 
150 system. The following control functions are explained in detail in this 
section. 


Function Code 


Function 


(0,16) 

(0,17) 

( 0 , 18 ) 

(0,19) 

( 0 , 20 ) 

( 0 , 21 ) 

(0,22) - (0,24) 
(0,25) 

(0,26) 

(0,27) - (0,31) 


Execute Two-Character Escape Sequence 

Position Cursor 

Define Enhancements 

Cursor Sense Absolute 

Cursor Sense Relative 

Set Cursor Type 

Not Used 

Read Fast AGIOS Entry Address 
Go to Terminal Mode 
Not Used 


Your application can use function (0,l6) to execute most of the two-character 
escape sequences supported on the HP 150 system. 

The HP 150 system supports two cursor types, blinking underline or blinking 
inverse box. You can use function (0,21) to set to the preferred cursor type. 

AIOS functions (0,17), (0,19), and (0,20) let you manipulate the cursor. Your 
application can sense the current cursor position as well as position it 
anywhere within the display. Your application can also use function (0,18) to 
define display enhancements. The HP 150 allows zero or more enhancements to be 
assigned to any character cell or any segment of a line on the display. 







AIOS Function Reference 


Execute Two-Character Sequence (ESC Char) 

Input Buffer : 

(0,l6) Function Code 

OP-CHAR The character equivalent of a 2-character escape 

sequence. Any operation characters are valid except for 
those that return data. The following list defines some 
of the most common ones. 


0 

Dump Alpha to Printer 

U 

Next 

1 

Set tab 

V 

Previous 

2 

Clear tab 

W 

Format Mode On 

3 

Clear all tabs 

X 

Format Mode Off 

4 

Set left margin 

Y 

Display Functions On 

5 

Set right margin 

Z 

Display Functions Off 

9 

Clear margins 

[ 

Start Unprotected Field 

e 

Delay one second 

] 

End Unprotected Field 

A 

Cursor up 

b 

Unlock Keyboard 

B 

Cursor down 

c 

Lock Keyboard 

C 

Cursor right 

g 

Soft Reset Terminal 

D 

Cursor left 

h 

Home Up 

E 

Terminal hard reset 

i 

Back tab 

F 

Home down 

j 

Display User-Defined Softkey 

G 

Return 


Definition Menu 

H 

Home up 

k 

Exit User-Defined Softkey 

I 

Tab 


Definition Menu 

J 

Clear display 

1 

Memory Lock On 

K 

Clear line 

m 

Memory Lock Off 

L 

Insert one line 



M 

Delete one line 



N 

Insert character with wraparound 



0 

Delete character with wraparound 



P 

Delete character without wraparound 



Q 

Insert character without wraparound 



R 

Insert character off 



S 

Scroll up 



T 

Scroll down 




Outputs ; 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

This function generally executes faster than sending escape sequences. 
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Position Cursor (ESC & a) 


This function moves the cursor to a specified row and column depending 
given mode. 


Input Buffer : 


(0,17) 

MODE 


Bit 0: 

Bit 1: 

Bit 2: 

Bit 3: 

Bit 4: 

Bit 5: 

Bit 6: 

Bit 7: 
(COLUMN) 

(ROW) 


Function Code 
1 Byte 

Bit 7 0 


I I I I I I I I 


1 = Screen row address (0-23) 

0 = Display row address (0-U7) 

1 = Row address (relative to the current 
cursor position) 

0 = Absolute row address 

1 = Negative row address (only meaningful if 
bit 1=1) 

0 = Positive row address 

1 = Use given ROW to calculate new row address 
0 = Do not change row address 

1 = Screen column address (0-79) 

0 = Display column address (0-79) 

1 = Relative column address (relative to current 

cursor position) 

0 = Absolute column address 

1 = Negative column address (only meaningful if bit 

5 = 1) 

0 = Positive column address 

1 = Use given COLUMN to calculate new column address 
0 = Do not change column address 

A positive integer indicating the new column 
number (0-79) or the number of columns to move 
the cursor if bit 5 of the MODE parameter is set. 

A positive integer indicating the new ROW number 
(0-47) or the number of rows to move the cursor 
if bit 1 of the MODE parameter is set. 
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Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

Column and row parameters do not have to be both absolute or relative; they do 
not have to be both screen addresses or both display addresses. If positive or 
negative bit is set for an absolute address, the bit will be ignored. 

Row and column addresses do not both have to be changed. That is, you can 
choose to move the cursor to a different row without changing the column 
position, or vice versa. 

Example : 

This example has a program segment that calls function (0,17) to 
move the cursor to column 10 and row 5* 

;Build input buffer to call AIOS. 

IN_BUF DW 17 
DB 88H 
DW 9 
DW 4 


;Set up registers to call AIOS 
;DS register is assumed to be the 
MOV AX,4403H 
MOV BX,1 
MOV CX,7 

MOV DX,OFFSET IN_BUF 

INT 21H 

RET 


current data segment 
;I/0 control write 
;console handle 
;7-byte buffer 
;buffer offset 

;MS-DOS call to move the cursor 
;return 


;position cursor function code 
;M0DE - gives row and column 
;move to COLUMN 10 
;move to ROW 5 
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Define Enhancements (ESC & d). 

Input Buffer : 

(0,18) Function Code 

SECURITY 1 byte 

10H = ON 

This means that characters are not displayed 
on the screen. 


OH = OFF 

This means that characters are displayed 
on the screen. 

ENHANCEMENT 1 byte 

An enhancement code from (UOH) through 

’0’ (UF). 

Display Enhancements Table 

Enhancements: |@ABCDEFGHIJKLMNO 


Half-Bright 
Underline 
Inverse Video 
Blinking 
No Enhancement 


X X 
X X 


X X 
X 
X 


X X X X 


X X 
X X 


XXX 
XXX 
X X 
X X 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks: 

The specified enhancement code applies to characters at and to the right of the 
current cursor position. The enhancement remains active until a NO enhancement 
code (@) is specified, the end of the cursor line is reached, or the cursor is 
moved to another line. 
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Cursor Sense Absolute (ESC a) 

This function returns the current cursor’s absolute display column and row. 
Input Buffer : 


(0,19) 

Function Code 

((BUFFER)) 

A double-word pointer to a buffer where two words are 
returned. The first word is the column number and the 
second word is the row number. 


First word = Buffer offset address 

Second word = Buffer segment address 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

(BUFFER) 

First word = Absolute display column (0-79) 

Second word = Absolute display row (0-47) 
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Cursor Sense Relative (ESC ') 

This function returns the current cursor’s relative screen column and row. 
Input Buffer : 

( 0 , 20 ) 

((BUFFER)) 


Outputs : 

AX = 0 
AX <> 0 

(BUFFER) 
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Function Code 

A double-word pointer to a buffer where two words are 
returned. The first word is the column number and the 
second word is the row number. 

First word = Buffer offset address 
Second word = Buffer segment address 


Successful 

Unsuccessful 

First word = Screen column (0-79) 
Second word = Screen row (0-23) 
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Set Cursor Type 

This function sets the alphanumeric cursor type 


Input Buffer: 


(0,21) 

Function Code 

(,TYPE) 

Alpha cursor type: 0 = Blinking underscore 

1 = Blinking inverse box 

(The high byte is a "don’t care".) 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function just changes the physical appearance of the cursor; it does not 
change the cursor type field in the HP 150 Global Configuration Menu. 
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Read Fast AGIOS Entry Address 

This function returns the segment and offset address of the entry point for 
executing AGIOS functions. Calling this returned address executes AGIOS 
functions faster than using MS-DOS function hex because the MS-DOS function 
overhead’ is eliminated. In order to call the returned address, your 
application has to set up the same input buffer as required by function kk hex 
and the following registers: 


CX = Number of bytes in the input buffer 
DX = Input buffer’s offset address 
DS = Input buffer’s segment address 


Input Buffer : 

(0,25) 

((BUFFER)) 


Outputs : 

AX = 0 
AX<> 0 

(BUFFER) 


Function Code 

A double-word pointer to a 2-word buffer where 
the entry address will be returned. 


Successful 

Unsuccessful 


First word = AGIOS entry offset address 
Second word = AGIOS entry segment address 

Remarks : 

To call AGIOS using the returned address, AX and BX registers are not required. 
Upon return from the fast call, the contents in AX, SP, and segment registers 
remain unchanged; the other registers are destroyed. 


| NOTE 

This function is included in Operating System version B.01.00 
or later. 
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Go to Terminal Mode 

This function lets your application switch to Terminal mode programmatically. A 
user can return to the application (Computer mode) by pressing [Shift][Stop] 
keys from the keyboard. 

Input Buffer: 

(0,26) Function Code 


Outputs : 


Successful 

Unsuccessful 


AX = 0 
AX <> 0 


Remarks : 

This function operates the same as pressing the Terminal softkey from P.A.M. 


NOTE 


This function is included in Operating System version B.01.00 
or later. 
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TOUCHSCREEN FUNCTIONS (ESC - z) 


The touch features on the HP 150 can be programmed in a variety of ways. The 
two general types of touch operations are "Field" operations and "Row/Column" 
operations. These two types can be intermixed. 

Several of the touchscreen function calls in this section assume Keycode mode. 
(Refer to the section on Keycode Mode for information on this mode.) 

This section gives the AIOS function calls that support the touchscreen. The 
following touchscreen functions are explained in detail in this section. 


Function Code 


Function 


(0,32) 

(0,33) 

(0,3*0 

(0,35) 

(0,36) 

(0,37) - (0,39) 


Define Touch Field 
Define Softkey Field 
Delete Touch Field 
Touchscreen Reset 
Set Touch Reporting Modes 
Not Used 


Field Operations 


There are four types of touch fields you can define. They are: 


ASCII FIELDS. This mode is very similar to the user-definable softkeys. A 

buffer of characters is associated with a touch field. A response string of 
0 to 80 ASCII characters is obtained by consecutive keyboard input 
operations. The first input obtains the first ASCII byte, and the second 
input obtains the second ASCII byte, etc. The response string is generated 
when the field is touched and should be indistinguishable from the typing of 
the same string from the keyboard. When Keycode mode is on, the qualifier 
word of each data byte returned to the application has the touchscreen ID 
(0FFH). Auto-repeat is performed. 


KEYCODE FIELDS. Keycode fields require that the terminal is in Keycode mode. 
There are two words in the response string; they are a qualifier word and a 
keycode word. The qualifier word has the keyboard ID (0C0H). Auto-repeat is 
performed. This type of field is not supported when defined with the ESC - z 
g sequence. 


TOGGLE FIELDS. The touch field is defined as a toggle switch. Touching the 
area toggles the field on and off. Whenever the field is touched, sensing 
information is passed to the application. The sensing information consists 
of three data bytes. The first byte is the touch status (ON or OFF). The 
other two bytes are the defined response string; they are usually used to 
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identify the field. The data is obtained by three consecutive keyboard input 
operations. If Keycode mode is on, the qualifier word of each data byte 
returned to the application has the touchscreen ID (80 hex). The three data 
bytes for toggle on field report are: 

01H - Toggle on field report code 
D1 - Response string first byte 
D2 - Response string second byte 

The three data bytes for toggle off field 
report are: 

02H - Toggle off field report code 
D1 - Response string first byte 
D2 - Response string second byte 


NORMAL FIELDS. This type of touch field senses touch and/or release. The 
sensing information consists of three data bytes. The first byte is the 
touch status (touch or release). The next two bytes are the defined response 
string; they are usually used to identify the field. The data can be 
obtained by three consecutive keyboard input operations. When Keycode mode 
is on, the qualifier word of each data byte returned to the application has 
the touchscreen ID (80 hex). Auto-repeat is performed. The three data bytes 
for field touched report are: 

05H - Field touched report code 
D1 - Response string first byte 
D2 - Response string second byte 

The three data bytes for field released 
report are: 

06H - Field released report code 
D1 - Response string first byte 
D2 - Response string second byte 

Again, the main difference between toggle fields and normal fields is that 
toggle fields have two states, ON and OFF. A normal field is ON only while it 
is actually touched. 
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Row/Column Operations 


This type of touch operation returns the row and column position when a touch 
occurs. The row and column position are returned byte by byte using the 
keyboard input function of the operating system. Three data bytes are returned. 
The first byte is the touch status (touch or release). The second byte is the 
touched row number, and the third byte is the touched column number. If Keycode 
mode is on, then the qualifier word returned with each byte of data has the 
touchscreen ID (080 hex). The three data bytes for touched row/column report 
are: 

03H - Row column touch report code 
Row - Touched row number in binary 
Col - Touched column number in binary 

The three data bytes for released row/column report are: 

OUH - Row column release report code 
Row - Touched row number in binary 
Col - Touched col number in binary 
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General Procedure for Using Touchscreen 

The following lists a recommended procedure for programming the touchscreen. 
Steps 1-5 should always be done; they may be executed all at once using the 
AGIOS Batch Command, function (0,0). If your application needs to control 
keyboard and touchscreen inputs, then steps 6-8 should also be included. 

1. Delete all fields using function (0,3*0 

2. Enable softkey reporting for all 8 softkeys using function (0,33) 

3. Select touchscreen reporting mode, using function (0,36) 

4. Define fields, if any, using function (0,32) 

5. Turn on touchscreen using function (0,36) 

6. If necessary, turn on Keycode mode using function (0,43) 

7. Define key characteristics using function (0,40) 

8. Put console device in Raw mode using MS-DOS function 44 hex (MS-DOS function 
44 hex is discussed in the Microsoft Prograrrmer’s Reference Manual.) 


4-38 



AIOS Function Reference 


Define Touch Field (ESC - z g) 

This function lets you define a touch field. 


Input Buffer : 

(0,32) 

((STRING)) 


(LENGTH) 

(ATTRIBUTE,MODE) 


Function Code 

A double-word pointer to the buffer which 
stores the response string. 

Keycode field: (2 words) 

First word = Qualifier 
Second word = Keycode 

Toggle or Normal Field: (2 bytes) 

ASCII data 

ASCII field: (0-80 bytes) 

ASCII data 

Number of bytes in the response string 

Touch ATTRIBUTE: 

1 = ASCII field 

2 = Keycode field (not supported when defined 

with escape sequence.) 

3 = Toggle field 
U = Normal Field 

Reporting MODE (only valid for ATTRIBUTE 1 
and U above) 

1 = Report when touched 

2 = Report when released 

3 = Report both touch and release 
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(ON-ENH,OFF-ENH) 


The ON and OFF enhancements of toggle fields. 
For ASCII, keycode and normal fields, ON-ENH 
is the enhancement when the field is touched; 
OFF-ENH is the enhancement when the field 
is not touched. 


Display Enhancements Table 


Security off: 

1 


A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Security on : 

1 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

Y 

Z 

[ 

\ 

] 


- 

Half-Bright 

1 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 

1 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 

1 



X 

X 



X 

X 



X 

X 



X 

X 

Blinking 

No Enhancement 

1 

1 

X 

X 


X 


X 


X 


X 


X 


X 


X 


(CURSOR,BEEP) 


CURSOR: 

0 = Do not change the cursor position 
1 = When touch, position the cursor 

to the upper left corner of the field 


(LR-ROW,LR-COL) 


(UL-ROW,UL-COL) 


BEEP: 

0 = Do not beep 
1 = Beep on touch 

Row and column of the lower right corner of 
the touch field; row and column are 
display relative. 

LR-ROW = 0-47 
LR-COL = 0-79 

Row and column of the upper left corner of 
the touch field; row and column are 
display relative. 

UL-ROW = 0-47 
UL-COL = 0-79 


Remarks: 


To define a Keycode field, you must supply a valid keycode from the Keycode 
Table that appears in the Keyboard Processing section. Furthermore, the system 
always returns the Keyboard Device ID (0C0H) for Keycode fields, regardless of 
what you supply in the Qualifier word. (See the section on Keycode mode for 
more information.) 


Appendix B has an example on defining touch fields from BASIC. 
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Define Softkey Field (ESC - z s) 


This function defines one of the eight softkey label areas as a touch field. 
These fields when touched produce the same response as if the corresponding 
function key is pressed. The default is all softkey touch fields are on. 


Input Buffer : 

(0,33) 
(MODE,KEY) 


Outputs : 

AX = 0 
AX <> 0 

Remarks: 


Function Code 

KEY (Softkey number): 1-8 

MODE: 1 = softkey label is touch sensitive 

0 = softkey label is not touch sensitive 


Successful 

Unsuccessful 


In general, softkey touch field should not be turned off. 
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Delete Touch Field (ESC - z d). 

Deletes the touch field with upper left corner at the given row and column. The 
row and column are display relative coordinates. 

Input Buffer : 

(0,34) Function Code 

(UL-ROW,UL-COL) Row and column position in the field to be deleted. 

UL-ROW = 0-U7 
UL-COL = 0-79 

When UL-ROW = OFFH and UL-COL = OFFH, all fields 
will be deleted. 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks : 

Actually, parameters UL-ROW and UL-COL do not have to be the upper left corner 
of the field. This function deletes a field as long as UL-ROW and U1-C0L 
specify a position within the desired field. 

If overlapping fields are defined, then the most recently created field will be 
deleted. 

If there is no touch field at the given row and column position, nothing 
happens. 

During initialization, your application should delete all touch fields that may 
be defined by an earlier application executed on the system. 
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Touchscreen Reset (ESC - z j) 

Turn all touch fields to the OFF state 
Input Buffer : 

(0,35) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

This function does not delete any touch fields. It just turns all touch fields 
off; all fields are displayed with OFF enhancements. 
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Set Touch Reporting Modes (ESC - z n) 

This function determines if, and how, touchscreen reporting is handled by the HP 

150. 

Input Buffer : 

(0,36) Function Code 

(,SCREEN-MODE) Touch Field and Row/Column sensing: (The high byte 

is a "don’t care".) 

0 - Disable reporting. This has the effect of turning 

off reporting without deleting any fields. 

1 - Enable sensing for row/column position. Touch 

fields are inactive. 

2 - Enable sensing for touch fields only. Row/column 

sensing is inactive. 

3 - Enable sensing for both row/column and touch 

fields. Row/column sensing occurs for areas not 
defined as touch fields. 

4 - Toggles touchscreen on and off. When OFF, all 

touchscreen operations are disabled. This disables 
softkey fields as well. The start-up default value 
is ON. 

10 - 14 Same as 0-4, but causes escape sequence reports to 

be sent in the following form. 

ESC - z <string> <type>Q <Carriage Return> 

with <type> : 

1 = Toggle field turning on report, <string> 

is the two-character response string. 

2 = Toggle field turning off report, 

<string> is the two-character response 
string. 

3 = Row/Column touch report, <string> is 

<row> x <column> y. 

4 = Row/Column release report, <string> is 

<row> x <column> y. 

5 = Normal field touch report, <string> is 

the two-character response string. 
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6 = Normal field release report, <string> 
is the two-character response string. 

(,TOUCH-MODE) Sense touch or release: (used with 

Row/Column sensing only; the high 
byte is a "don’t care") 

1 - Report on Touch 

2 - Report on Release 

3 - Report on both Touch and Release 


Outputs : 

AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks: 


If an application wishes to disable touchscreen, it should set the SCREEN-MODE 
parameter to ’O’. 
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KEYBOARD PROCESSING 


Keyboard Processing functions let you gain more control over the use of the 
keyboard and touchscreen. This section gives the AIOS function calls that 
support keyboard processing. The following keyboard processing functions are 
explained in detail in this section. 


Function Code 


Function 


(0,40) 

(0,41) 

(0,42) 


Define Key Characteristics 
Get Key Characteristics 
Put Key 


The keyboard consists of two types of keys: 


o The ASCII keys (letters, digits, control codes, and punctuation marks). 


o Special keys which can be divided into two classes: 

- numeric/graphics keypad keys 

- other special function keys (Insert Line, Insert Character, etc.) 

There is a keycode assigned to each special function key on the keyboard. These 
keycodes are listed in the Keycode table in this section. It should be noted 
that the keycodes for [fl] through [fl2] are valid only when the application 
softkey labels are enabled with AIOS function call (0,11). 


Key Characteristics 

Using the Keyboard Processing functions, each of the special keyboard functions 
can be individually set to normal processing or one of the special processing 
modes (beep, intercept, or ignore). 


NORMAL. This is the default action where the system processes the key. 

INTERCEPT. The key is passed to the application; no action is performed by the 
system. 


IGNORE. No system action is performed and no report is generated. 

BEEP. The system generates a ’beep’ when a key is pressed in combination with 
the above characteristics. 

In order to gain total control of reading keys from the keyboard or from the 
touchscreen, your application should be in keyboard intercept mode. That is, 
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your application should first define each of the special keys on the keyboard to 
the desired mode of operation, put the operating system's console input device 
into Raw mode, and turn on Keycode mode. 

You can use AIOS function (0,40) to define each special function key to the 
desired mode. You can choose to process the key normally, intercept the key, or 
ignore the key. You will probably notice that the ASCII displayable characters 
are not in the Keycode table that appears later in this section. This is 
because whenever Keycode mode and Raw mode are ON, the ASCII keys are 
intercepted automatically. 

Whenever the operating system’s console input device is in Raw mode, all those 
keyboard functions that are normally processed by the operating system will be 
passed to your application without any interpretation by the operating system. 
You should use the MS-DOS function 44 hex to put the console input device into 
Raw mode. The default is Raw mode OFF (see the Microsoft Programmer's Reference 
Manual for more information on function 44 hex.) There is also a sample program 
segment on turning Raw mode on and off in the next section on Keycode mode. 

Whenever Keycode mode is ON, your application will receive 4 bytes of 
information for each key stroke, two bytes of Data and two bytes of Qualifiers. 
You should use AIOS function (0,43) to turn on Keycode mode. (See the next 
section on Keycode Mode for more information on reading keycodes.) 

As a result, to properly use keyboard processing functions to control the 
keyboard and touchscreen, your application should: 

1. Define special function key characteristics to either process, intercept, or 
ignore keys. (Use AIOS function (0,40)) 

2. Set the console input device into Raw mode so that keys are not executed by 
the operating system. (Use MS-DOS function 44 hex) 

3. Turn on Keycode mode to examine the key attributes. (Use AIOS function 
(0,U3)) 

Note that if any of the above three modes is not set up correctly, then your 
application will not be able to gain total control of the keyboard and the 
touchscreen. 

Once your application is set up to control the keyboard and touchscreen, there 
is no explicit "get keycode and qualifier" function call. The standard 
operating system console input function returns the normal ASCII code and also 
keycode. The qualifiers are also returned if Keycode mode is ON. If Keycode 
mode is ON, you may use MS-DOS function call 3F hex to read 4 bytes of data for 
each keypress. 

After your application examines the pressed key, it can either process it 
specially by the application or process it normally by the system. To process a 
key normally after it has been intercepted in Keycode mode and Raw mode, use the 
AIOS Put Key function (0,42). 
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Special Keyboard Keys Definition 

The following section describes how the HP 150 system interprets some of the 
special keys on the keyboard. An application can intercept, inhibit, or alter 
the meaning of some of these keys. 

[Break] and [Reset] Keys 

[Break] 

This key sends a data communications break signal to the remote computer. 

[Shift] [Break] 

This key causes a soft-reset of the HP 150 system. An application cannot 
intercept this key. 

[CTRL] [Shift] [Break] 

This key causes a hard-reset of the HP 150 system. An application cannot 
intercept this key. 

[Stop] Key 

[Stop] 

This key toggles between starting and stopping the system. It causes the HP 150 
to enter a loop waiting for a [Stop] or a hard-reset keypress. 

[Shift] [Stop] 

In Terminal mode, the HP 150 will attempt to load the operating system. 

[CTRL] [Stop] 

This key functions identically to [Shift] [Stop]. However, an application 
cannot intercept this key. 

[Enter] Key 

[Enter] 

In Block mode, this key can be strapped for line or page transmission using no 
handshaking, short handshaking (DC1), or long handshaking (DC1/DC2/DC1). You 
can select the Return key to act as if it were the Enter key in the Terminal 
Configuration menu. 

[Shift] [Enter] 

This key sends the entire alphanumeric display data to the currently selected 
print device. 

[CTRL] [Enter] 

The key does a raster dump of the graphics display memory to the currently 
selected print device. 
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[Menu] Key 

[Menu] 

This key toggles the softkey labels on and off. If softkey labels are toggled 
off, you can press [User System], [Shift] [User System], or [Ctrl] [User System] 
to display the softkey labels again. You should remember that softkeys are 
still active even when their labels are hidden. 


[Shift] [Menu] 

This key does not perform any function in the HP 150 system, but it is 
interceptable. 

[CTRL] [Menu] 

This key displays the User-Definable Softkey Menu. An application cannot 
intercept this key. 

[CTRL] [Shift] [Menu] 

This key toggles the entire touchscreen on or off. An application cannot 
intercept this key. 


[User System] Key 

[User System] 

This key displays the current level of system softkeys. Pressing [User System] 
a second time always displays the root level of the system softkeys. 

[Shift] [User System] 

This key displays the application softkeys. An application cannot intercept 
this key. 

[CTRL] [User System] 

This key displays the User-Defined softkeys. An application cannot intercept 
this key. 

Cursor Movement Key 


[Select] 

An application can use this key to let a user select the item at which the 
cursor is pointing. If this key is not intercepted, it sends an "ESC & p" 
sequence, which does not perform any action in the HP 150. 


Local Editing Keys 

[Shift] [Clear Line] 

This key clears the current cursor 

[Shift] [Clear Display] 

This key clears the entire display 


line regardless of current 


cursor pos 


ition. 


memory regardless of current cursor po 


sition. 
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Alphanumeric Scroll Key 

[Next] 

This key moves the display memory text up in the screen so the line immediately 
following the current last screen line becomes the new first screen line. 

[Next] always leaves at least one defined line (possibly a blank line) in the 
screen. [Next] positions the cursor in Row 1 and Column 1 at the end of this 
operation. 

[Prev] 

This key moves the display memory text down in the screen so the line 
immediately preceeding the current first screen line becomes the new last screen 
line. If there are not enough lines to fill the screen, [Prev] places the first 
line of display memory at the top of the screen. [Prevj positions the cursor in 
Row 1 and column 1 at the end of this operation. 

Numeric/Graphics Keypad 

[CTRL] [Keypad "-"] 

This key toggles between Numeric Pad and Graphics Pad modes. 

In Graphics Pad mode, the keypad keys return the same keycodes or perform the 
same functions as the corresponding graphics function keys on the main keyboard. 

In Numeric Pad mode without interception, the keypad keys return ASCII codes 
corresponding to the characters on the keycaps. 

In Numeric Pad mode with interception, the keypad keys return unique keycodes 
(e.g., the numeric-pad zero key is different from the main-keyboard zero key), 
which are also independent of the Shift key. 

You should note that pressing the Shift key along with a numeric-pad key 
displays a different character on the screen, but the Keycode returned is 
independent of the Shift Key. Therefore, your application should examine the 
’Special’ and ’Shift’ bits in the Qualifier Word to distinguish the various 
permutations. 
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The shifted Numeric Pad keys are mapped as follows: 


Numeric Keypad Keys 

Equivalent Character 

[Shift] 

[■] 

Tilde 

[Shift] 

[0] 

Caret " A " 

[Shift] 

[1] 

Left Brace "{" 

[Shift] 

[2] 

Vertical Bar M |" 

[Shift] 

[3] 

Right Brace ")" 

[Shift] 

[»•] 

Left Bracket "[" 

[Shift] 

[5] 

Backslash "\ M 

[Shift] 

[6] 

Right Bracket ”]" 

[Shift] 

[7] 

Cross Hatch "#" 

[Shift] 

[8] 

Back Quote 

[Shift] 

19] 

Commercial At 
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Keycode Table 


Key(s) 

Keycode 

Key( 3 ) 

Keycode 

fl 

00H 

Insert-Line 

UUH 

f2 

01H 

Delete-Line 

U5H 

f3 

02H 

Insert-Char with wraparound 

46H 

fU 

03H 

Delete-Char with wraparound 

U7H 

f6 

05H 

Shift/Clear-display 

48H 

f7 

o6h 

Sh ift/Clear-1ine 

49H 

f8 

07H 



f9 

08H 

Enter 

5 OH 

fio 

09 H 

User System 

51H 

fll 

OAH 

Select 

52H 

fl 2 

OBH 

Menu 

53H 



Break 

5 UH 

Cursor-Up 

20H 

ESC 

55H 

Cursor-Down 

21H 

CAPS 

56 h 

Cursor-Right 

22H 

DEL 

57H 

Cursor-Left 

23H 

Stop 

58H 



Shift/Menu 

59H 

Tab 

2UH 

Shift/Stop 

5AH 

Return 

25H 

Shift/Enter 

5BH 

Back-tab 

26H 

CTRL/Enter 

5CH 

Back-space 

27H 



Scroll-Down 

28H 

Graphics Pad: 


-Up 

29H 

Cursor-Left 

6 lH 

-Left 

2 AH 

Cursor-Down 

62H 

-Right 

2BH 

Cursor-Right 

63H 



Roll-Up 

64H 

Home-Up 

2CH 

Cursor-Up 

65 H 

Home-Down 

2DH 

Roll-Left 

66 h 



Roll-Down 

67H 

Next 

2EH 

Roll-Right 

68 H 

Prev 

2FH 

Clear Display 

69 H 



Pad-Toggle 

6 AH 

Insert-Char 

UOH 

Alpha-Display 

6BH 

Delete-Char 

UlH 

Graphics-Cursor 

6CH 

Clear-Display 

U2H 

Graphics Display 

6DH 

Clear-Line 

U3H 

Home-Up 

6EH 



Home-Down 

6FH 


«»»**«* Th ere are more keycodes listed on the next page 
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Key(s) 

Keycode 

Numeric Pad: 

Zero 

3 OH 

One 

31H 

Two 

32H 

Three 

33H 

Four 

3UH 

Five 

35H 

Six 

36h 

Seven 

37H 

Eight 

38H 

Nine 

39H 

Minus 

70H 

Asterisk 

71H 

Plus 

72H 

Slash 

73H 

Comma 

7UH 

Enter 

75H 

Tab 

76H 

Period 

77H 


NOTE 


Keycodes OCH - 1FH and UAH - UFH are not used. 
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Keycode Notes 

1. Function keys fl-fl2 and the numeric-pad keys return the same keycodes 
independent of [Shift] and [CTRL] key operation. Your application can 
examine the Qualifier word to distinguish the various permutations. 

2. Applications cannot intercept other functions that are not listed in the 
Keycode table. The non-interceptable functions are listed below: 

Soft Reset ([Shift] [Break]) 

Hard Reset ([CTRL] [Shift] [Break]) 

Abort ([CTRL] [Stop]) 

User-Definable Softkey Menu ([CTRL] [Menu]) 

Touchscreen On/Off ([CTRL] [Shift] [Menu]) 

Application Softkeys ([Shift] [User System]) 

User-Defined Softkeys ([CTRL] [User System]) 

3. If [CTRL] and [Shift] are both depressed with a key for which the 
combination is not defined, the keycode returned will be the same as if only 
[CTRL] were pressed. However, the Qualifier word will indicate both 
qualifiers, [CTRL] and [Shift] 

(See the section on Reading Keycodes for additional information on Qualifier 
word.) 
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Define Key Characteristics 


: function lets you alter characteristics of any of the Special keys, not the 
ASCII keys. Specifically you can: - 

o Process the key normally 

o Intercept the key and pass a keycode to the application for processing 
o Ignore the key when it is pressed 

o Beep when the key is pressed in combination with the above characteristics 
Input Buffer : 

(0»^0) Function Code 

(CHARACTERISTICS) Key Characteristics 


Bit 15 210 


| <-Reserved-> | 


Bit 0 = 1 => Beep 

Bit 1 = 1 => Intercept 

Bit 2 = 1 => Ignore 

3*15 Reserved (should be set to zero) 

If bits 1 and 2 are both set, the key is treated 
as an intercept key. When both are zero, the 
key resumes normal functioning. 

(KEYCODE) Keycode corresponds to the Special key on the 

keyboard to be defined. A value of OFEH will 
set all Special keys to the specified 
characteristics. (See the Keycode Table listed 
earlier for valid keycodes.) 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

**«*»«* g ee ^ exaiJ1 pi e Q f this function on the next page ******* 
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Example : 

The following example defines all keys to be intercepted. 


Build the input buffer to call AIOS function (0,U0). 


IN BUF 

DW 

40 

;define key characteristics 


DW 

2 

;set intercept mode 


DW 

OFEH 

;keycode = all keys 


Set up registers to call AIOS function. 

DS is assumed to be the buffer’s data segment. 


MOV 

AX,UU03H 

;I/0 control write 

MOV 

BX,1 

;console handle 

MOV 

CX,6 

;6 bytes in input buffer 

MOV 

DX, OFFSET 

IN BUF ;input buffer offset address 

INT 

21H 

;call AGIOS 

RET 


;return 
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Get Key Characteristics 

This function returns the characteristics of a Special key. 


Input Buffer : 

( 0 , 1 * 1 ) 

((BUFFER)) 


(KEYCODE) 


Outputs : 

AX = 0 
AX <> 0 

(BUFFER) 


Function Code 


A double-word pointer to a 1-word buffer where th< 
key’s characteristics will be returned. 


First word = Buffer offset address 
Second word = Buffer segment address 


The keycode corresponds to the desired Special 
key (see Keycode Table listed earlier for 
valid keycodes). 


Successful 

Unsuccessful 

The characteristic word is defined as follows: 
Bit 15 210 


■Reserved-> | | | 


Bit 0 = 1 
Bit 1 = 1 
Bit 2 = 1 


Beep 

Intercept 

Ignore 
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Put Key 

This function lets you direct the system to process the keycode normally. For 
example, an application can intercept a keypress and then use this function to 
tell the system to process the key normally. 


Input Buffer: 


(0,H2) 

Function Code 

(QUALIFIER) 

Qualifier 

15 8 0 

Bits: | ID | S | R | LE | RE | CT | LS | RS | RP | 

(KEYCODE) 

Bit Interpretation (l=set, 0=not set) 

15“8 = Input Device ID 

(should be set to the keyboard ID * OCOH) 

7 = Special key (must be set). 

6 = Reserved 

5 = Left extend char, set when down 

U = Right extend char, set when down 

3 = Control, set when down 

2 = Left shift, set when down 

1 = Right shift, set when down 

0 = Not used 

The keycode corresponds to the desired Special key. 

(See Keycode Table listed earlier for valid keycodes). 

Outputs: 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function can be used to simulate keyboard pressing of a Special key. 
Therefore, the high byte of the parameter QUALIFIER should be set to OCOH for 
keyboard input. (See the section on Reading Keycodes presented later for more 
information.) 

For normal ASCII keys, you would simply print (or ’echo’) the character in place 
of using this function. 
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KEYCODE MODE 


Keycode mode allows applications to obtain additional control over the HP 150 
keyboard. By using this mode, your application can detect keypresses as well as 
the state of the five ’shift-type’ keys: left and right [Shift] key; left and 
right [Extend char] keys; and the [CTRL] key. It also lets you distinguish 
between touchscreen and keyboard input. 

To obtain this control requires no special interrupts or calls; all keycode 
activity is directed to standard console input. 

This section gives the AIOS function calls that support Keycode mode. It also 
lists the function that reads the Graphics/Numeric keypad status. The following 
functions are explained in detail in this section. 


Function Code 


Function 


( 0 , 43 ) 

Turn 

(0,44) 

Read 

(0,45) 

Read 

(0,46) 

Read 


Keycode Mode On/Off 
Keycode Mode Status 
Numeric/Graphics Keypad Status 
Key 


Using Keycode Mode 

Keycode mode is normally used with Raw mode and keyboard intercept. To properly 
use Keycode mode, your application will need to do the following set-up: 


o Define Key Characteristics with AIOS call (0,U0) 
o Turn on Raw Mode with MS-DOS call kk hex 
o Turn off Control-C checking with MS-DOS call 33 hex 
o Turn on Keycode mode with AIOS call (0,U3) 


When all this has been done, your application will need to read four bytes of 
data for each keypress; more will be said on this shortly (see Reading 
Keycodes). 
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Defining Special Keys 

Key characteristics can be specified for any of the Special function keys on the 
HP 150. Key characteristics include the ability to process a key normally, to 
intercept a key, or to ignore it. When in Keycode mode, each key characteristic 
is affected in the following way: 


NORMAL. This is the default action; the system processes the key. 

INTERCEPT. The system generates 4 bytes for each key pressed. When in this 
mode, your application should be set up to read 4 bytes per key input. 


IGNORE. No system action is performed and no report is generated. 

You can also have the HP 150 ’beep’ when individual keys are pressed, in any 
combination with the other key characteristics. (See AIOS function (0,40) for 
additional information on Define Key characteristics.) 
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Using Raw Mode 

MS-DOS has two processing modes: Cooked mode and Raw mode. In Cooked mode, the 
default mode for devices, MS-DOS checks each character for special significance. 
For example, Tab, Back Space, Control-P, and Control-Z all have special meanings 
to MS-DOS. When a device is in Raw mode, MS-DOS stops checking for these 
special characters. Keys are passed to your application without any 
interpretation by MS-DOS. Raw mode generally allows faster operation on 


devices. 


The following sample assembly routines turn Raw mode on and off. 


RAWON: MOV AX,U400H 


;Get device information 
;File handle = 1 for console 


MOV BX,1 
I NT 21H 
XOR DH,DH 
OR DL,20H 
MOV AX,4401H 
MOV BX,1 
INT 21H 
RET 


;Clear high byte for put 


;Set raw bit without changing other bits 

;Put device information 

;File handle = 1 for console 

;Turn on Raw mode 

;Done = return to caller 


RAWOFF: MOV AX,UU00H 



;Get device information 
;File handle = 1 for console 


MOV BX,1 
I NT 21H 
XOR DH,DH 
AND DL,ODFH 
MOV AX,UU01H 
MOV BX,1 
I NT 21H 
RET 


;Clear high byte for put 

;Clear raw bit without changing other bits 
;Put device information 
;File handle = 1 for console 
;Tum off Raw mode 
;Return to caller 


Control-C trapping is normally handled by MS-DOS when I/O function calls occur. 
You want to verify that this is disabled by setting Control-C trapping off with 
MS-DOS function 33 hex. 
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Turning On Keycode Mode 


Finally, 

turn 

on Keycode mode 

with AGIOS call (0,43). 

SETKC: 

MOV 

AX,UU03H 

;I0 Ctrl Write 


MOV 

BX,1 

;Console handle 


MOV 

CX,3 

;Buf length 


MOV 

DX,OFFSET BUF 



INT 

21H 



RET 



BUF 

DB 

43 

;Keycode mode function number 


DB 

0 

;AIOS index 


DB 

1 

;Keycode mode on 


Before your application ends, be sure to ’clean up’. This usually means setting 
all keys to their default characteristics, turning off Keycode mode, and setting 
Cooked mode on the console. This is good programming practice and means the 
next program to run will not have problems because of your application. 




4-62 






AIOS Function Reference 


Reading Keycodes 

Once Keycode mode is enabled, each keypress generates four bytes: Device ID, 
Shift Bits, Null, and Data. Device ID and Shift Bits bytes together are called 
the Qualifier word, and Null and Data bytes together are called the Data word. 
You should note that if you are reading these four bytes of information in byte 
mode, they are listed in the following order: 

Shift Bits <-first byte 

Device ID 
Data 

Null <-last byte 

However, in word mode, then they are stored in pairs of 16 bits: 

(Device ID, Shift Bits) 

(Null, Data) 


QUALIFIER WORD The two-byte qualifier word is in the following format: 
High Byte Low Byte 


| Device ID | Shift Bits | 


The high order byte (Device ID) field indicates which device was the source of 
the key. Possible values for Device ID are: 


Device ID 


Data Source 


00 Hex 
080 Hex 
0C0 Hex 
OFF Hex 


Internal Code 

Touchscreen (Keycode, Toggle, and Normal fields) 
Keyboard 

Touchscreen (ASCII field) 


Internal Code is used when the system responds to an inquiry (such as the 
default response string of the user-defined softkeys). 


NOTE 


If you select a softkey function by touching the softkey label 
on the screen, or if you touch a Keycode field defined on the 
screen, the system still returns the Keyboard Device ID (0C0H) 
in the Device ID byte. 
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The low order byte (Shift Bits) field indicates additional information about the 
keypress. You can determine which, if any, shift keys were depressed; or 
whether the key is an ASCII key or a Special key; or whether this keypress is 
due to auto-repeating on the keyboard. The format of the Shift Bits byte is 
listed below: 

Bits 7 0 


| S : R: LE : RE : CT : LS : RS : RP | 


The meaning of each bit follows: 

S: Special Bit. This bit indicates the key is one of the 

’Special’ keys and the Data Word contains a keycode from 
the Keycode Table listed in the Keyboard Processing 
Section. When this bit is cleared, the Data Word 
contains a Roman-8 ASCII character code. 

R: Reserved Bit. This bit is reserved for future 

expansion. 

LE: These bits indicate the state of the left (LE) and right 

RE: (RE) [Extend char] key. These keys normally shift into 

additional 8 bit ASCII characters. 

CT: This bit indicates the control key [CTRL] was pressed. 

LS: These bits indicate the state of the left (LS) and right 

RS: (RS) shift keys. Note that when the Special Bit is 

cleared, the ASCII code in Data Word will correspond to 
upper or lower case ASCII codes independent of the state 
of these bits. That is, you do not need to check these 
bits to see if a character is upper case or not; the 
proper ASCII code is returned to you in the Data Word. 

RP: This bit indicates that the device is auto-repeating and 

this key is a result of a previous key which has been 
held down. If auto-repeating keys are not acceptable to 
your application, you can check this bit and ignore the 
keypress if the bit was set. 
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DATA WORD. The format of the Data Word follows: 

High Byte Low Byte 

+-+ 

| Null | Data | 

+ - + 

The high order byte (Null) is null and will be all zeros. 

The low order byte (Data) contains sin ASCII code if the Special Bit was cleared 
or a Keycode value if the Special Bit was set. 

If the Data is ASCII, the case will correspond to the proper upper or lower case 
ASCII code. There is no need to check the state of the Shift Bits. 

Note that some languages ignore null input. BASIC is an example of such a 
language, and you will not be able to perform keycode input in these languages. 
It is suggested you use an assembler input routine to accept this data. You may 
further wish to use an input function which does not process Control-C. MS-DOS 
function 7 is an example of such a function. (See the Microsoft Programmer's 
Manual for details.) 
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Touchscreen Input in Keycode Mode 

In Keycode mode, the touchscreen will return reports in the same format as when 

not in Keycode mode. However, each character will return four bytes (Qualifier 

Word and Data Word). Let’s review each type of field and row/column reports. 

ASCII FIELD. When Keycode mode is on, each character in the ASCII field buffer 
will be reported as four bytes. (This is another good reason to keep field 
lengths to a minimum!) The Device ID byte is set to OFF hex to indicate a 
touchscreen ASCII field. 

KEYCODE FIELDS. This type of field allows you to specify a Qualifier Word and 
a Keycode Word. You will receive just those four bytes on return. The 
Device ID byte is set to 80 hex to indicate a touchscreen Keycode field. 

TOGGLE AND NORMAL FIELDS. These two fields each return three-character 

reports in normal mode. The first data byte is the touch status (ON or OFF); 
the next two bytes are the defined response string. They are usually used to 
identify the touch field. In Keycode mode, you will receive four bytes for 
each of these three characters. In other words, you will receive 12 bytes of 
data for each report in Toggle fields and Normal fields. The Device ID byte 
is set to 80 hex to indicate touchscreen Toggle or Normal fields. 

ROW/COLUMN REPORTS. In normal mode, you receive three-character row/column 
reports. The first data byte is the touch status (ON or OFF); the second 
byte is the touched row number; the third byte is the touched column number. 
When Keycode mode is on, you will receive four bytes for each of these three 
characters, which means you must process 12 characters for each report. The 
Device ID byte is set to 80 hex to indicate touchscreen row/column report. 
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Softkeys in Keycode Mode 

The user-defined softkeys are reported as a buffer of text and are defined with 
the ESC & f escape sequence. You will find that, like ASCII touch fields, you 
receive four bytes for each character in the user-defined softkey buffer. 

If you are using application softkeys, you will receive only a four-byte report, 
two keycode bytes and two qualifier bytes. Note that application softkeys will 
set the Special bit in the Qualifier word, and the Data word represents a 
keycode. 
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Turn Keycode Mode On/Off 

This function turns Keycode mode of the console device ON or OFF 
Input Buffer : 


(0,43) 

Function Code 

MODE 

Keycode mode: 

1 = ON 

0 = OFF 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



If Keycode mode is OFF, each key pressed on the keyboard returns one byte of 
data when the console input device is read. If Keycode mode is ON, each 
keypress returns four bytes of data. The first two bytes form a word of 
qualifiers and the next two bytes form a word of key data. See Keycode Mode on 
the previous pages for more details. 
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Read Keycode Mode Status 

This function returns the ON or OFF status of Keycode mode. 


Input Buffer : 

(0,UU) 

((BUFFER)) 


Outputs : 

AX = 0 
AX <> 0 


Function Code 

A double-word pointer to a byte location where the 
Keycode mode ON/OFF status is returned. 

First word = Buffer offset address 
Second word = Buffer segment address 

0 = Keycode mode OFF 
1 = Keycode mode ON 


Successful 

Unsuccessful 
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Read Numeric/Graphics Keypad Status 

This function returns the status of whether the extened keypad is in Numeric 
mode or Graphics mode. 


Input Buffer : 

(0,U5) 

((BUFFER)) 


Outputs : 

AX = 0 
AX <> 0 


Function Code 

A double-word pointer to a byte location where 
the keypad status is returned. 

First word = Buffer offset address 
Second word = Buffer segment address 


Successful 

Unsuccessful 


BUFFER 


Remarks: 


0 = numeric mode 
1 = graphics mode 


Your application should set the desired setting of the Numeric/Graphics keypad. 
The keypad can be altered by the following escape sequences: 

ESC & k 0 0 Turn on Numeric keypad 

ESC & k 1 0 Turn on Graphics keypad 
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Read Key 

This function returns the key qualifiers and the keycode of the key entered from 
the keyboard. Keycode mode can be ON or OFF. 

Input Buffer : 

(0,46) 

((BUFFER)) 

Outputs : 

AX = 0 
AX <> 0 

(BUFFER) 

First Word Qualifier 

Second Word Keycode 

Remarks: 

This function does not actually read (remove) characters from the keyboard input 
buffer; it just returns the key’s information in a specified buffer. To flush 
the keyboard input buffer, your application has to perform console-reads. 

This function is useful because it lets you examine the keycode and qualifiers 
without turning on Keycode mode. 


Function Code 

A double-word pointer to a 2-word buffer where the 
Qualifier word and the Keycode word will be returned. 


Successful 

Unsuccessful 


NOTE 


This function is included in Operating System Version 
B.01.00 or later. 
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SECTION 


GRAPHICS INPUT/OUTPUT 
SUBSYSTEM FUNCTION REFERENCE 


INTRODUCTION 



This section lists functions in the Graphics Input and Output Subsystem (GIOS) 
in numerical order according to the function number. If you do not already know 
the procedure for calling Alphanumeric and Graphics Input and Output Subsystem 
(AGIOS) functions, and are not familiar with parentheses and positional 
notations used in the function reference, you should read Section 3 on AGIOS 
programming first. 


GIOS FUNCTIONS 


Each GIOS function is identified by a l6-bit function code as shown below: 

Bit 15 0 

+ - + 

I 4 I X | 

+ - + 

high low 
byte byte 

For GIOS functions, the high byte of the function code is always a number "1*". 
The low byte (X) is the function number. The function code must be the first 
parameter stored in the input buffer. The other parameters, if any, must be 
stored in the buffer in the order that is listed in the function description. 

In this section, a GIOS function code is given in decimal and is represented by 
an ordered-pair (U,X). You should note that the Intel processor interprets the 
two bytes in a word in reverse order, that is, in memory, the value X is stored 
before the value U. 


There are two ways to define a function code; you can define it either in 
byte-mode or in word-mode using Microsoft Macro Assembler directives Define Byte 
(DB) or Define Word (DW). 
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For example, to allocate a buffer called IN_BUF and store the function code 
(U,l) in the first word of IN_BUF, you can use either one of the following 
instructions: 

In Byte Mode: IN_BUF DB 1,U 

In Word Mode: IN_BUF DW 0U01H 

The above two instructions both allocate a buffer called IN_BUF and store the 
value 1 in the first byte and the value U in the second byte of the buffer. 

GIOS lets you programmatically control the following graphics functions: 

o Display Control 
o Vector Drawing Mode 
o Graphics Text 
o Graphics Plotting 
o Graphics Status 

For information on using Graphics escape sequences, refer to Appendix D on 
Graphics Control Functions. 
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DISPLAY CONTROL (ESC * d) 


The graphics and alphanumeric data are displayed in the same area on the screen, 
but they are stored in separate display memory. This lets you read or modify 
graphics and alphanumeric data separately. 

The alphanumeric display memory has lines; only 2k data lines are visible on 
the screen at any time. The softkey labels are located at rows 25 and 26 and 
the status line is located at row 27. 

The graphics display memory size is 512 pixels (horizontal) by 390 pixels 
(vertical). The graphics display is actually larger in screen area than the 
alpha display. 
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This section describes the GIOS functions that support the alphanumeric and 
graphics displays. The following display control functions are explained in 
detail in this section. 


Function Code 

Function 

<4,i) 

Clear Graphics Memory 

(4,2) 

Set Graphics Memory 

(4,3) 

Turn 

On Graphics Display 

(4,4) 

Turn 

Off Graphics Display 

(4,5 

Turn 

On Alphanumeric Display 

(4,6) 

Turn 

Off Alphanumeric Display 

(4,7) 

Turn 

On Graphics Cursor 

(4,8) 

Turn 

Off Graphics Cursor 

(4,9) 

Turn 

On Rubber Band Line 

(4,10) 

Turn 

Off Rubber Band Line 

(4,11) 

Move 

Graphics Cursor Absolute 

(4,12) 

Move 

Graphics Cursor Incremental 

(4,13) 

Turn 

On Alphanumeric Cursor 

(4,14) 

Turn 

Off Alphanumeric Cursor 

(4,15) 

Turn 

On Graphics Text Mode 

(4,16) 

Turn 

Off Graphics Text Mode 


Since the alphanumeric and graphics displays and cursors operate independently, 
your application can use the above GIOS functions to set up the ON or OFF state 
of each one of them. 
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Clear Graphics Memory (ESC * d a) 

This function clears graphics display memory. The entire displayable graphics 
area of 512 x 390 pixels is turned off. 

Input Buffer : 

(4,1) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

This function blanks out the graphics display memory. 

Example : 

The following assembly program segment builds an input buffer and calls function 
(U,1) to clear graphics memory. 


;Build input buffer 
5 

IN_BUF DW 0401H ;function code 


Set up registers to call GIOS. The input buffer’s segment 
address is assumed to be in DS already. 


MOV 

AX,4403H 

;I/0 control write 

MOV 

BX,1 

;device handle 

MOV 

CX, 2 

;2 bytes in input buffer 

MOV 

DX,OFFSET IN BUF 

;input buffer offset address 

INT 

21H 

;call MS-DOS to clear memory 

RET 


;return 
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Set Graphics Memory (ESC * d b) 

This function sets graphics display memory. The entire displayable graphics 
area of 512 x 390 pixels is turned on. 

Input Buffer : 

(U,2) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks: 

Setting graphics display memory turns the entire graphics display to green. 
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Turn On Graphics Display (ESC * d c) 

This function turns on the graphics display. The data in graphics memory is not 
affected. 

Input Buffer : 

(4,3) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

If the graphics cursor is ON, then it will be displayed. 

Alphanumeric data and cursor are not affected. 
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Turn Off Graphics Display (ESC * d d) 

This function turns off the graphics display. The data in graphics memory is 
not affected. 

Input Buffer : 

(U,U) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

If the graphics cursor is ON, then it will be hidden. 

Alphanumeric data and cursor are not affected. 
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Turn On Alphanumeric Display (ESC * d e) 

This f\inction turns on the alphanumeric display. The data in alphanumeric 
memory is not affected. 

Input Buffer : 

(U,5) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

This function also turns on the alphanumeric cursor. 

Graphics data and cursor are not affected. 
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Turn Off Alphanumeric Display (ESC * d f) 

This function turns off the alphanumeric display. The data in alphanumeric 
memory is not affected. 

Input Buffer : 

(U,6) Function Code 

Outputs : 

AX = 0 Successful 

AX = <> 0 Unsuccessful 

Remarks: 

If the alphanumeric cursor is ON, then it will be hidden. 

Graphics data and cursor are not affected. 
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Turn On Graphics Cursor (ESC * d k) 


This function turns on the graphics cursor. 


Input Buffer : 

(*t.7) 


Function Code 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

The graphics cursor is initially OFF (power on or hard reset). Turning the 
cursor on or off does not affect the data in graphics memory. 

The graphics cursor may be toggled on and off by pressing the [Graph cursor] key 
on the Graphics/Numeric pad in Graphics Pad mode. 

Alphanumeric data and cursor are not affected. 
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Turn Off Graphics Cursor (ESC * d I) 

This function turns off the graphics cursor. 
Input Buffer : 

(U,8) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks: 

Alphanumeric data and cursor are not affected. 
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Turn On Rubber Band Line (ESC * d m) 

This function turns on the rubber band line and graphics cursor. 

Input Buffer : 

(U,9) 

Outputs : 

AX = 0 
AX <> 0 

Remarks: 

The default state (power on or hard reset) for the rubber band line and graphics 
cursor is OFF. 

The graphics rubber band line is a line with its fixed point at the current pen 
position and its moveable point at the graphics cursor. The "pen" is an 
imaginary drawing pen and the "current pen position" is the point that was last 
moved to or drawn to. 

Turning on the graphics rubber band line turns on the graphics cursor and draws 
a rubber band line between the cursor and the current pen position. When either 
the cursor or the pen moves, the rubber band line moves also. 


Function Code 


Successful 

Unsuccessful 
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Turn Off Rubber Band Line (ESC * d n) 

This function turns off the rubber band line. 


Input Buffer: 


(*»,io) 

Function Code 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



The graphics cursor is not affected. 
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Move Graphics Cursor Absolute (ESC * d <x>,<y> o) 

This function moves the graphics cursor to the specified absolute location. 
Input Buffer : 

(MD 

(X-COORD) 

(Y-COORD) 

Outputs : 

AX = 0 
AX <> 0 

Remarks : 

Although the value of X-COORD and Y-COORD parameters can be in the range of 
-16384 to + 16383 , the absolute display coordinates are from 0 to 511 in the X 
direction and from 0 to 389 in the Y direction. If you specify a value outside 
of these ranges, the cursor will be positioned at the edge of the screen in the 
absolute X or Y direction. 

The cursor is moved even if it is turned off. 


Function Code 

The X coordinate of the new cursor position expressed as 
an absolute number in the range from -16384 to 16383 . 

The Y coordinate of the new cursor position expressed as 
an absolute number in the range from -16384 to 16383 . 


Successful 

Unsuccessful 
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Move Graphics Cursor Incremental (ESC * d <x>,<y> p) 

This function moves the graphics cursor to a specified location that is relative 
to the current cursor position. 

Input Buffer : 


(M2) 

Function Code 

(X-COORD) 

The X coordinate of the new cursor position expressed as 
a number that is relative to the current cursor 
position. Its range extends from -32768 to +32767* 

(Y-COORD) 

The Y coordinate of the new cursor position expressed as 
a number that is relative to the current cursor 
position. Its range extends from -32768 to +32767* 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



In this function, X-COORD and Y-COORD are added to the current cursor position 
to produce a resultant position where the cursor is to be moved. 


The cursor is moved even if it is turned off. 
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Turn On Alphanumeric Cursor (ESC * d q) 

This function turns on the alphanumeric cursor. 
Input Buffer : 

(*♦*13) Function Code 

Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

The data in the alphanumeric memory is not affected. 
Graphics data and cursor are not affected. 




5-17 













GIOS Function Reference 


Turn Off Alphanumeric Cursor (ESC * d r) 

This function turns off the alphanumeric cursor. 


Input Buffer: 


(MU) 

Function Code 

Outputs: 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



The data in the alphanumeric memory is not affected 


Graphics data and cursor are not affected. 
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Turn On Graphics Text Mode (ESC * d s) 

This function turns on Graphics Text mode. Characters that normally go to the 
alphanumeric display will be drawn on the graphics display. 

Input Buffer : 

(4,15) Function Code 

Outputs : 

AX = 0 
AX <> 0 

Remarks : 

The text is drawn with the current text attributes. Text attributes can be 
defined using GIOS functions (4,29) " (*03). Graphics Text mode is described 
later in the section on Graphics Text. 


Successful 

Unsuccessful 
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Turn Off Graphics Text Mode (ESC * d t) 


This function turns 

off Graphics Text mode. 


Input Buffer : 


<U,l6) 

Function Code 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



Graphics Text mode is described later in the section on Graphics Text. 
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VECTOR DRAWING MODE (ESC * m) 


There are several parameters that cam be set to allow a wide variety of drawing 
capabilities. These parameters define line or area patterns to be used when 
drawing vectors or polygons, position the relocatable origin, or define graphics 
text attributes. 

This section describes the GIOS functions that support vector drawing. The 
following vector drawing functions are explained in detail in this section: 

Function Code Function 

(4.17) Select Drawing Mode 

(4.18) Select Line Type 

(4.19) Define Line Pattern and Scale 


(U,20) 

(4.21) 

(4.22) 

(4.23) 

(4.24) 

(4.25) 

(4.26) 

(4.27) 

(4.28) 


Define Area Fill Pattern 

Fill Rectangular Area, Absolute 

Fill Rectangular Area, Relocatable 

Select Polygonal Fill Pattern 

Select Boundary Pen 

Set No Polygon Boundary 

Set Relocatable Origin 

Set Relocatable Origin to Current Pen Position 
Set Relocatable Origin to Current Cursor Position 



Appendix D has additional information on using Graphics Vector Drawing mode and 
(ESC * m) sequence. 
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Select Drawing Mode (ESC * m <mode> a) 

This function selects the vector drawing mode. 

Input Buffer : 

(4,17) 

(MODE) 


Outputs : 

AX = 0 
AX <> 0 

Remarks: 

Vectors can be drawn by setting, clearing, or complementing the data in the 
graphics memory. Normally the memory is cleared and vectors are drawn by 
setting selected bits to make green lines on a dark screen. If instead you want 
black vectors on a green screen, you can begin by setting graphics memory (Set 
Graphics Memory function (4,2)), select a clear mode, and draw dark vectors. 


Function Code 
Drawing Mode: 

0 = Graphics memory not changed 

1 = Clear mode 

2 = Set mode 

3 = Complement mode 

4 = Jam mode 


Successful 

Unsuccessful 


CLEAR MODE. Clear mode causes selected display bits to be turned off. The 
"selected bits" are those that are ON in the line pattern. (Function (U,l8) 
lets you select line type.) If a solid line type (the default) has been 
selected, all of the bits in the vector will be selected. In clear mode this 
means that all of the dots making up a vector will be turned off. This allows 
you to draw dark vectors on a green background. Only those bits that are in the 
pattern are cleared. Bits that are OFF in the pattern do not affect the 
display. 


SET MODE. Set mode is similar to clear mode except that the selected bits are 
turned on instead of off. Only the bits that are ON in the line type are 
affected. 


COMPLEMENT MODE. Complement mode causes the selected display bits to change 
state (ON to OFF, OFF to ON). Again, only those bits that are ON in the line 
type or pattern are affected. 
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JAM MODE. Jam mode differs from the other modes in that both the bits that are 
ON and OFF in the line type or pattern affect the display. Jam mode has the 
effect of overlaying the display with the pattern. 


NOTE 


On the HP 150, Graphics Text drawn with Jam mode functions 
identically to Graphics Text drawn with Set mode. The 
illustration on the next page shows Jam mode used for Graphics 
Text. 


SELECTIVE ERASE. A vector drawn in set mode can be selectively erased by 
redrawing it in clear mode. This will cause gaps to occur if the erased line is 
intersected by other lines. This problem can be overcome by initially drawing 
the line in complement mode and then redrawing it in complement mode to erase 
the line. This technique will preserve the original display. Complement mode 
is useful for drawing and erasing temporary figures. 

******* See an illustration of drawing mode on the next page ******* 
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Original Screen Pattern to be drawn over Original Screen 



Mode 0 (No effect on original screen) 



Mode 3 (Complement mode-toggles Mode 4 (Jam mode-the same as set 

the pattern over the original screen) mode on this terminal) 
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Figure 5~1- Graphics Drawing Mode 
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Select Line Type (ESC * m <type> b) 

This function selects the vector line type. 
Input Buffer : 


(M8) 

(TYPE) 


Function Code 
Line Type 

1 Solid line (default) 

2 User defined line pattern 

3 Current area pattern 

4 Predefined pattern #1 

5 Predefined pattern #2 

6 Predefined pattern #3 

7 Predefined pattern #4 

8 Predefined pattern #5 

9 Predefined pattern #6 

10 Predefined pattern #7 

11 Point plot 


4 -- 

5 =- 

6 * - 

7 * . 

8 = - 

9 x . 

10 -- 

11 = (POINT PLOT) 


Outputs : 

AX = 0 
AX <> 0 

Remarks: 


Successful 

Unsuccessful 


You can select the dot pattern used when drawing vectors or filling rectangular 
areas. Dotted and dashed lines can be drawn by selecting one of nine predefined 
patterns or a user-defined line or area pattern. This allows you to use 
different line patterns to distinguish between groups of plotted data or to 
easily generate shading and cross hatching for use in engineering drawings, 
graphs or fabric patterns. 

You can select one of eleven line types. The default line type is a solid line 
(type !)• Once the line type has been selected, all drawing vectors are drawn 
using that line type. 
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Point, plot causes a single point to fee plotted at the coordinates specified by 
the data. This line type is useful for generating scattergram" graphs. 

If current area shading is selected Hype = 3) the line patterns used are 
selected from the eight lines making up the area fill pattern (refer to Define 
Area Pattern function (U,20)). The display is divided into groups of eight rows 
and eight columns. Horizontal and vertical lines are drawn using the 
appropriate row or column from the area pattern. Diagonal lines are drawn using 
a solid vector. If a line is longer than 8 dots, the pattern is repeated to 
complete the vector. See the Illustration below. 


128 64 32 16 8 4 2 1 




Figure 5“2. Area Fill Pattern 
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Define Line Pattern and Scale (ESC * m <pattern><scale> c) 

This function defines a user line pattern and scale. 

Input Buffer ; 

(M9) 

(,PATTERN) 


(SCALE) 


Outputs : 

AX = 0 
AX <> 0 

Remarks: 

The dot pattern used to draw vectors can be defined programmatically. Once a 
pattern is defined, you must select the user-defined line type (type = 2) using 
the Select Line Type function (4,18). 

A user-defined line pattern is composed of a dot pattern and a scale factor. 

The dot pattern is a sequence of eight l’s and 0’s. Using the default drawing 
mode (Set mode), points indicated as a "1" in the pattern are drawn, and the 
points indicated as a "0" are left unchanged. 

The pattern is given as a decimal number between 0 and 255 that is the decimal 
equivalent of the 8-bit binary pattern. The default pattern is all M l"s (255)* 
For example, .... = 10101010 (binary) = 170 (decimal). The actual number used 
for the pattern can be between -32768 and 32767* The least significant 8 bits 
of the number’s 2’s complement equivalent are used to determine the pattern. 

The scale factor indicates how many times each bit in the pattern is repeated. 
For example, a scale factor of 3 applied to the pattern defined above results in 
a pattern of . or 111000111000111000111000 (binary). 

Example : 

Define a pattern to generate the following vector: 

11111111110011001111111111001100 
pattern = 11111010 = 250 
scale = 2 


Function Code 

The line pattern is an integer in the range of 
0 to 255* (The high byte is a "don’t care".) 

The line scale is an integer in the range of 
1 to 255 * 


Successful 

Unsuccessful 
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Those area patterns too complex to be obtained from an 8x8 area pattern can be 
generated by plotting a series of lines and varying the patterns used for 
successive lines. Complex patterns such as those used in weaving can be 
generated easily using this technique. 



Figure 5“3* Examples of User-Defined Line Types 
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Define Area Fill Pattern (ESC * m <pattern> d) 


This function defines a user area fill pattern of 8 dots by 8 dots (8X8) on the 
screen. 


Input Buffer : 

(U,20) 


Function Code 


(,DATA ROWO) 
(,DATA R0W1) 
(,DATA R0W2) 
(,DATA R0W3) 
(,DATA ROWU) 
(,DATA R0W5) 
(,DATA R0W6) 
(,DATA R0W7) 


You specify all eight rows of the 8x8 fill pattern. 
Each DATA-ROW is an eight-bit byte which defines a 
particular row of the pattern. (The high byte is a 
"don’t care".) 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks: 


The display is divided into 8 dot by 8 dot cells. Every point on the display is 
mapped to a corresponding bit in the pattern. 

The user area pattern is defined by 8 parameters, one for every row of dots in 
the pattern. Each parameter is interpreted as a 2’s complement number, and the 
least significant 8-bits are used to obtain a value between 0 and 255. The 
8-bit number (0 to 255) represents an 8-bit binary pattern. Bits set to 1 are 
drawn, and bits set to 0 (zero) are not drawn (depending on the current drawing 
mode). Function (U,17) lets you select the current drawing mode. 

The user area pattern can also be used to provide line patterns for horizontal 
or vertical lines when the area pattern is selected as a line type (type=3). 
(Refer to Select Line Type function (U,l8) for additional information.) Drawing 
horizontal or vertical lines causes the corresponding row or column of the 
pattern to be used as the line pattern. Diagonal vectors will always be drawn 
using a solid line. Irregular shapes can also be built up by selecting the area 
shading pattern and then using successive horizontal and vertical lines. 

The default area fill pattern is a solid-filled pattern . 

#*###*# See ^ exain pi e 0 f this function on the next page ******* 
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Example : Define a simple checkerboard pattern. 


Row 0 

= 

10101010 

= 

170 

Row 1 

= 

01010101 

= 

85 

Row 2 

= 

10101010 

= 

170 

Row 3 

= 

01010101 

= 

85 

Row 4 

= 

10101010 

= 

170 

Row 5 

= 

01010101 

= 

85 

Row 6 

= 

10101010 

= 

170 

Row 7 

= 

01010101 

= 

85 


The 8080 assembly sample program segment to define the above pattern 
is as follows: 


; Build the input buffer 


IN BUF 


DB 

20,4 

function code 

DW 

170 

DATA ROWO 

DW 

85 

DATA R0W1 

DW 

170 

DATA ROW2 

DW 

85 

DATA R0W3 

DW 

170 

DATA ROW4 

DW 

85 

DATA ROW5 

DW 

170 

DATA ROW6 

DW 

85 

DATA R0W7 


Set up registers to call GIOS functions 

DS is assumed to have the default data segment 


MOV 

AX,4403H 

;I/0 Control write 

MOV 

BX,1 

;console handle 

MOV 

CX,l8 

;buffer length 

MOV 

DX,OFFSET IN BUF 

;buffer address 

INT 

21H 

;execute GIOS function 

CMP 

0 

;check return status 

JNZ 

ERROR 

;process error 

RET 


;otherwise, return. 


ERROR: 
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Other examples of user-defined patterns are shown below. 


128 32 8 2 


Row 7 
Row 6 
Row 5 
Row 4 
Row 3 
Row 2 
Row 1 
Row 0 



24 

36 

66 

129 

129 

66 

36 

24 



(a) 


(b) 


Row 6 
Row 5 
Row 4 

Row 2 
Row 1 
Row 0 



85 

170 

85 

170 

85 

170 

85 

170 





Figure 5 - ^- Examples of User-Defined Area Fill Patterns 
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Fill Rectangular Area, Absolute 
(ESC * m <x1>,<y1> <x2>,<y2> e) 

This function fills a rectangular area with the selected area fill pattern. The 
rectangular region is defined by specifying the lower left and upper right 
coordinates. 

Input Buffer : 

(4,21) 

(LWR LEFT X-COORD) 

(LWR LEFT Y-COORD) 

(UPR RIGHT X-COORD) 

(UPR RIGHT Y-COORD) 


Outputs : 

AX = 0 
AX <> 0 

Remarks : 

A rectangular area cam be filled with one of a variety of predefined patterns or 
with a user-defined pattern. The pattern can also be used to provide line 
patterns for horizontal or vertical lines when the area pattern is selected as 
the line type. (Refer to Select Line Type function (4,18) and Define Area Fill 
Pattern function (4,20) for additional information.) 

When an area fill pattern is selected, the entire screen is divided into 8x8 
cells. Each location is mapped to the corresponding bit in the pattern. When 
an area fill operation is performed, the area fill pattern is duplicated to fill 
the area. 


Function Code 

The X,Y absolute coordinates of the lower left corner of 
the rectangular area to be filled. 

The X,Y absolute coordinates of the upper right corner 
of the rectangular area to be filled. 

Each coordinate is in the range of -16384 to + 16383 . 


Successful 

Unsuccessful 
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This function fills a rectangular area with the selected area fill pattern. The 
rectangular region is defined by specifying the lower left and upper right 
coordinates. 


Input Buffer : 

(4,22) 


Function Code 


(LWR LEFT X-COORD) The X,Y relocatable coordinates of the lower left corner 
(LWR LEFT Y-COORD) of the rectangular area to be filled. 


(UPR RIGHT X-COORD) The X,Y relocatable coordinates of the upper right 
(UPR RIGHT Y-COORD) corner of the rectangular area to to be filled. 


Each coordinate is in the range from -32768 to + 32767 . 


Outputs : 



AX = 0 
AX <> 0 

Remarks: 


Successful 

Unsuccessful 


The given coordinates are added to the relocatable origin. The resultant values 
are then treated as absolute coordinates. Functions (4,26), (4,27), (4,28), and 
(4,49) has additonal information on relocatable origin. 

A rectangular area can be filled with one of a variety of predefined patterns or 
with a user-defined pattern. The pattern can also be used to provide line 
patterns for horizontal or vertical lines when the area pattern is selected as 
the line type. (Refer to Select Line Type function (4,18) and Define Area Fill 
Pattern function (4,20) for additional information.) 


When an area fill pattern is selected, the entire screen is divided into 8x8 
cells. Each location is mapped to the corresponding bit in the pattern. When 
an area fill operation is performed, the area fill pattern is duplicated to fill 
the area. 
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Select Polygonal Fill Pattern (ESC * m <pattern> g) 

This function selects a pattern for polygonal and rectangular area fill 
Input Buffer : 

(4,23) Function Code 

(PATTERN) Area Fill Pattern: 

1 = Solid fill pattern 

2 = User-defined fill pattern 

3 = Dotted hatching 

4 = Dashed hatching 

5 = Hatching 

6 = Cross hatching 

7 = Fine hatching 

8 = Medium checkerboard 

9 = Fine checkerboard, 1:1 blend 
10 = Fine checkerboard, 3:1 blend 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks: 


The default pattern for polygonal area fill is a user-defined pattern . 
(4,20) lets you define a user-defined area fill pattern. 


5 - 3 >* 


Function 
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Select Boundary Pen (ESC * m <pen> h) 

This function selects the pen to be used to draw the boundary of a filled 
polygon. The boundary is drawn with a solid line pattern. 

Input Buffer : 

(4,24) 

(PEN) 

Outputs : 

AX = C 
AX <> 0 

Remarks: 

Since the HP 150 is a black and green system, the selected pen number is not 
significant. Any number assigned to (PEN) will generate a solid green boundary 
line. 

The default setting is no polygon boundary . Function (4,25) turns polygon 
boundary OFF. 


Function Code 

Boundary Pen Number (see Remarks below). 

Successful 

Unsuccessful 
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Set No Polygon Boundary (ESC * m h) 

This function turns off drawing of boundary around a polygon 


Input Buffer: 


(i*,25) 

Function Code 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



Function (U,2U) lets you select (enable) the boundary pen 
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Set Relocatable Origin (ESC * m <x>,<y> j) 

This function sets the relocatable origin to the specified absolute location. 
Input Buffer : 

( 4 , 26 ) 

(X-COORD) 

(Y-COORD) 

Outputs : 

AX = 0 
AX <> 0 

Remarks ; 

The relocatable origin lets you use one set of data and drawing commands to 
display a figure at several different positions on the screen. The value of the 
relocatable origin is added to the relocatable data to obtain the coordinates 
used to draw the figure. Once you change the relocatable orign, you have to 
re-draw the figure in order to see the relocation. 

The following figure illustrates the effect of a relocatable origin on the 
display: 


Function Code 

The X coordinate is the new relocatable origin expressed 
as an absolute number in the range of -16384 to +16383. 

The Y coordinate is the new relocatable origin expressed 
as an absolute number in the range of -16384 to +16383. 


Successful 

Unsuccessful 



Figure 5-5. An Example of Using the Relocatable Origin 

There are four GIOS functions for setting the graphics relocatable origin: 

o Set Relocatable Origin in Absolute Coordinates, function (4,26) 
o Set Relocatable Origin to Current Pen Position, functions (4,27) and (4,49) 
o Set Relocatable Origin to Current Cursor Position, function (4,28) 

The default relocatable origin is at (0,0), the lower left corner of the 
display. 
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Set Relocatable Origin to Current Pen Position (ESC * m k) 



This function sets the relocatable origin to the current pen position. 


Input Buffer : 

(U,27) 


Function Code 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks: 


The current pen position is the last point moved to or drawn to. 

The relocatable origin lets you use one set of data and drawing commands to 
display a figure at several different positions on the screen. The value of the 
relocatable origin is added to the relocatable data to obtain the coordinates 
used to draw the figure. Once you change the relocatable orign, you have to 
re-draw the figure in order to see the relocation. 
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Set Relocatable Origin to Current Cursor Position (ESC * m I) 

position^ 1011 S6tS ^ relocatable or igi“ to the current graphics cursor 


Input Buffer : 

(U,28) 

Outputs : 

AX = 0 
AX <> 0 

Remarks: 


Function Code 


Successful 

Unsuccessful 


disolav '1 r ^ ° rl J ln leta you use one set of da ta and drawing commands to 
rew + a figure at several different positions on the screen. The value of the 

used t H 16 °tK gl c 1S add6d tC th ® reloca table data to obtain the coordinates 
used to draw the figure. Once you change the relocatable orign, you have to 
re-draw the figure in order to see the relocation. 
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GRAPHICS TEXT (ESC * m) 


The HP ISO features a full graphics character set implemented in Read-Only 
ZZ (ROM). With graphics text, you can specify such attributes - slant 
size, and orientation of characters sent to the graphics display. G ”Phi« Text 
sequence (ESC * m) is described in Appendix D on Graphics Control Functions. 


You can also create your own custom characters, either one at a time or as a 
replacement for the entire set stored in the HP 150. 

This section gives the GIOS functions that support graphics text. The following 
graphics text functions are explained in detail in this section: 


Function Code Function 


(4.29) 

(4.30) 

(4.31) 

(4.32) 

(4.33) 

(4.34) 

(4.35) 

(4.36) 

(4.37) 

(4.38) 


Set Graphics Text Size 
Set Graphics Text Orientation 
Turn On Text Slant 
Turn Off Text Slant 
Set Graphics Text Origin 
Display Graphics Text Label 
Define User Character Set 
Select Default Character Set 
Output Single Text Character 
Set Graphics Defaults 


Functions (U,15) and (U,l6) listed earlier let you turn Graphics Text mode on 
and off, respectively. 


Functions (U,72) and (U,73) listed later let you set picture definition defaults 
and perform Graphics hard reset, respectively. 
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Set Graphics Text Size (ESC * m <size> m) 

This function sets the graphics text size. 

Input Buffer : 


(*♦,29) Function Code 

(X-SCALE) The X coordinate (width) scale factor for text 

characters. 

Bit 15 8 7 0 


I I 


(Y-SCALE) 


Outputs : 

AX = 0 
AX <> 0 

Remarks ? 


Bits 0-7 = fraction 
Bits 8-15 = integer 

The Y coordinate (height) scale factor for text 
characters. 

Bits 0-7 = fraction 
Bits 8-15 = integer 


Successful 

Unsuccessful 


The vector lists that define the user-defined character set are scaled using 
this text size. (See function (U,35) for more information on defining user 
character set.) 


The ESC * m <size> m" sequence only lets you set the 
values that is prescaled by the system. This function 
text size to a precision that is not available via the 


text size to one of eight 
lets you scale graphics 
escape sequence. 
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Example : 

The following example calculates the X-SCALE and Y-SCALE parameters for a text 
size of 21 pixels by 28 pixels: 

X-SCALE = 3 X 256 *-SCALE = 2.8 x 2 5 6 

_ 7 ^o = (1 I 

= 0300H (in hex) = 02CDH (in hex) 

nr,-,:;; ««...«. «.««< 

height. 

In order to move the integer portion of the scale to the high byte (bits 8-15), 
you can multiply the scale by 256. 


10 

Pixels 


"slz: 


GT 

4| : 

B 





7 

Pixels 


Pixels' Pixels 


Figure 5-6. Graphics Text Size (Scale=l, Text Origin^) 
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screenf“ re ^ Sh ° WS h ° W * SCale 1 graphics ^aracter is positioned on the 

° 1 u c r racters are generally drawn in a 5 pixels by 7 pixels matrix 

(5x7) which is m a 7 pixels by 10 pixels ( 7 x 10 ) character cell. 

o The bottom 2 pixels are not used except for cases like the "j" character. 

° th t character M ls drawn and the current pen position is at point A 
the character will be placed in the cell as shown above. T^e cur^nf^ 
position is moved to point B. enx pen 

° ~,“s;r;s ! n, a :‘™ivr ,or- i °™- ■ 

stroke*? uin + * * * , •••)• This also means the character 

Wll i nat get Proportionally thicker when scaled up. The width of a 
character stroke is the same as the width of a vector. 

IT r° Ve i 11 “ St r t i° n ShOWS hOW a 3cale 1 oharacter is displayed. If you 
inirei SCale . 2 ’ both the cha racter and the cell size will b£ doubled. As you 

the size ° f the — “ d - - 


I WOTE I 


A character cell whose scaled cell width is not an integer 
value (say 10.5 pixels wide) will be drawn on the display as a 
character with a cell width equal to the integer portion of the 
desired cell width (ie. 10 pixels wide). A string of these 
characters will, however, have its length adjusted by inserting 
extra pixels between appropriate adjacent characters. 

l tring of 30 characters whose scaled cell widths 
should be 10.5 Pixels each will generate a string whose width 
31.5 pixels. Similar adjustments occur with the character 
cell height. 
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Set Graphics Text Orientation (ESC * m <orientation> n) 

This function selects the graphics text orientation. This also changes the 
direction of line feed, carriage return, and backspace. 


Input Buffer : 

(1^30) Function Code 

(ORIENTATION) Graphics Text Orientation: 

1 = Normal (horizontal) 

2 = Rotate 90 degrees counterclockwise 

3 = Rotate 180 degrees counterclockwise 
U = Rotate 270 degrees counterclockwise 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks : 

The following diagram shows the four different orientations. 


I-J ylNUIMH 

X 

^ TEXT DIRECTION 


NO 1103*10 iX'Ji rn 
180 °/ 




X o 


* TEXT DIRECTION 
\t11133XW 1X3U ^ 


Figure 5-7. Graphics Text Orientation 
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Turn On Text Slant (ESC * m o) 

This function turns on the 26.57 degree slant of graphics text characters 


Input Buffer: 


(**•31) 

Function Code 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 
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Turn Off Text Slant (ESC * m p) 

This function turns off 26.57 degrees slant of graphics text characters. 
Input Buffer : 

(U # 32 ) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 
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Set Graphics Text Origin (ESC * m <origin> q) 

This function sets the graphics text origin to one of twelve positions of text 
justification. The positions are shown in this figure: 


Center Right 

-6.-9 

I 
I 
I 
I 

5 8 

I 

- 10 - -. 11 

I 
I 
I 

—U-7 

Input Buffer : 

(U,33) 

(ORIGIN) 

Outputs : 

AX = 0 
AX <> 0 

Remarks: 

Text strings can be automatically right or left justified, or centered about a 
specified point. The value given in the ORIGIN parameter indicates the 
justification and placement of characters with respect to the current pen 
position. 

If text is left justified, the current pen position is the left margin. Center 
causes the text to be centered on the pen position. Right justify selects the 
pen position as the right margin. Bottom, base line, middle and top select the 
part of the text string to be aligned with the current pen position. 


Function Code 
Graphics Text Origin: 
A number from 0 to 11. 

Successful 

Unsuccessful 


Left 
Top 3- 

I 

I 

I 

I 

Middle 2 

I 

Base line ->0 

I 

I 

I 

Bottom 1- 
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Display Graphics Text Label (ESC * I <text>) 

This function outputs a string of graphics characters. The label is drawn 
beginning at the current pen position. 


Input Buffer: 


(4,34) 

Function Code 

((TEXT)) 

Segment and offset address of a string of characters. 
The string must be terminated by Carriage Return (CR) 
Line Feed (LF), CR LF, or LF CR. The maximum length 
for TEXT is 73- 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



The text label is drawn with the current text attributes. Text attributes can 
be set up using GIOS functions (U,29), (4,30), (4,31), (4,32), (4,33). 
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Creating a Graphics Character 

In order to create your own graphics character set, let’s first look at the 
format of a single graphics text cell. A graphics character cell is 7 pixels 
wide by 10 pixels high. 


(3,8) 


> Base Line 


Each graphics character is stored as a vector list describing how the character 
is formed. Within this list, you must describe the character within a cell. 

The vector list format is: 


XLL, YLL, XUR, and YUR are coordinates for 
the lower left and upper right points of 
the character cell used in placing the 
character within the character grid. 


(XI,Yl), (X2,Y2) (Xn,Yn) are ordered 

pairs that describe the character strokes. 


The last (X,Y) must be (0,0) to indicate the end 
of the character stroke. 


XLL 


YLL 


XUR 


YUR 


X 1 


Y 1 


X 2 


Y 2 


X n 


Y n 



Each value in the above vector list is stored in "excess 64’s notation", 
means you must add 64 to the relative coordinate within each grid. 


which 
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The Vector List 

In the vector list illustrated above, the first four entries describe the cell 
size of a character of scale 1. These four bytes specify the lower left and the 
upper right coordinates. We can create a character cell in excess 64’s 
notation. This character cell is: 

+..+.—* (67,72) 


I (6U,64)| | 

+- # -+ > Base Line 

I I I 

( 60 , 62 ) *-.—♦-+ 

Given this ’standard size cell’, the first four entries in a vector list 
describing a character would be: 


+-+ 


60 

1 

_ 1 

-> Lower left X coordinate 

62 

1 

1 

_ 1 

-> Lower left Y coordinate 

67 

— 1 

1 

1 

-> Upper right X coordinate 

72 

1 

1 

-> Upper right Y coordinate 


After these first four bytes, the vector list specifies an (X,Y) coordinate pair 
for each endpoint in the character. The X coordinate represents the X value and 
the Y coordinate represents the Y value, both in excess 64’s notation. 

The bit structure for each coordinate pair is: 


Bit 7 6 0 


M/D | 

X-COORDINATE 

0 1 

Y-COORDINATE 


M/D 1 = Move, 0 = Draw 

X-COORDINATE X coordinate in excess 64 representation 

Y-COORDINATE Y coordinate in excess 64 representation 

If the most significant bit (bit 7) of the X coordinate is a "0", then the (X,Y) 
pair specifies a Draw mode. The ’pen’ draws to the (X,Y) point. If the most 
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significant bit (bit 7) is a "1", then the (X,Y) pair indicates a Move mode. 
The pen is lifted and moved to (X,Y). 


NOTE 


The (X,Y) pair used to draw a character does not have to be in 
the range specified by the first four values (XLL, YLL, XUR, 
YUR) because these four values are only used to place the 
character. 
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Building a Character 

The following example builds a single character using the character grid as 
shown earlier: 


(60,72) @-+-+ (67,72) 

I @ I @ (67,71) 

I % | £ % 

I % | 4 i 

I £ % 

I % |(6U,68) £ 

1 £ 1 £ 

1 @ 1 % 

(60,64) £-+-£-> Base Line 

I I @ 

( 60 , 62 ) +-+-£ (67,62) 


The steps in building a character vector list are listed below: 

o Start at the left base line by moving to (60, 6 U) 
o Draw to (67,71) 
o Draw to (67,62) 
o Move the pen to (60,72) 
o Draw to (64,68) 

The following program segment defines the vector list for the character 
illustrated above. 


CHAR DB 

60 


;X Lower 

Left 

DB 

62 


;Y Lower 

left 

DB 

67 


;X Upper Right 

DB 

72 


;Y Upper Right 

Note the +128 

indicates setting the ’move' 

' bit 

+ 0 indicates 

clearing the ’move’ 

bit (draw) 

DB 

60 + 

128 

;Move to 

(60,64) 

DB 

64 




DB 

67 + 

0 

;Draw to 

(67,71) 

DB 

71 




DB 

67 + 

0 

;Draw to 

( 67 , 62 ) 

DB 

62 




DB 

60 + 

128 

;Move to 

( 60 , 72 ) 

DB 

72 




DB 

64 + 

0 

;Draw to 

(64,68) 

DB 

68 




DB 

0 


;Last X 


DB 

0 


;Last Y 



Once you have built this list, you can use GIOS function (4,37) to output a 
single character. The character will be sent to the screen using the 
orientation, size, and slant characteristics that apply to graphics text. 
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Re-defining the Entire Character Set 

The HP 150 character set is defined by a table of 256 entries. The contents of 
this table are l 6 -bit pointers to character vector lists as described earlier. 
In fact, the entry into the Pointer Table is the ASCII code of the character. 
For example, the 65 th entry in the table of pointers corresponds to ASCII code 
65 decimal, which is the character ’A*. 

To re-define the HP 150 character set, you need to build a table of pointers to 
take the place of the ROM-based table. This entails creating your own table of 
256 l 6 -bit pointers. A pointer to a character vector list contains the 
difference between the address of that character vector list and the starting 
address of the Pointer Table. 

For example, if the character ’A’ vector list is defined at location 1750 and 
the Pointer Table’s starting address is set up at location 500, then the 65 th 
entry of the Pointer Table contains the value 1250. 

Character ’A’ Vector List : 1750 

Pointer Table Starting Address: 500 

65 th Table Entry Content : 1750-500 = 1250 
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The following figure shows the relationship between the Pointer Table and the 
Vector List Table: 


Pointer Table 

+- 

0 I 


I 


I 


31 I 0 | 

+-+ 

32 | (CHAR32 - Pointer Table) |-+ 

+ - + 

33 I (CHAR33 - Pointer Table)|.. 

+ - + 

I I 


I 


126 |(CHARI26 - Pointer Table)|-+ 

+ - + 

127 I 0 | 


I 


I 


I 


I 


160 | 0 

+ - 

l6l | (CHARI 6 1 - Pointer Table) |..+ 

+-+ 

i i 


i 


Vector List Table 

->>+ - + 

I I 

| CHAR32 | 

| Vector List | 


I CHAR33 | 

| Vector List | 


I 

->>+- 

I 


CHARI26 
Vector List 


| CHARl6l 
| Vector List 


CHAR25U I 
Vector List | 


254 | (CHAR25U - Pointer Table) |-+ 

+ - + 

255 I 0 | 
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An entry in the Pointer Table contains either 0 or the pointer to the vector 
list that corresponds to its 8-bit ASCII code. A table entry that contains zero 
is a null pointer* and indicates that no vector list is defined for this table 
entry. 

The first 32 entries in the table of pointers correspond to the ASCII control 
characters of values 0 through 31. These characters are not part of the HP 150 
graphics character set, but the table entries must exist and contain zero. The 
same is true for ASCII values 128 through 159* Pointers 160 through 255 
correspond to HP Roman-8 extensions. (You can usually access the HP Roman-8 
extensions using the [Extend char] key on the keyboard.) If your application 
does not use 8-bit ASCII codes, pointers 160 through 255 should be set to null. 

The 32nd character, ASCII Space, is an important entry in the table. The system 
uses its (XLL,YLL) and (XUR,YUR) values to calculate the new pen position when a 
back space or a line feed control character is received. The Space character 
will be displayed in place of any of the ASCII codes (33-126 and 161-254) whose 
pointers are null in the Pointer Table. Because of these special functions, a 
vector list must be defined for the Space character when defining a graphics 
character set. If the Space character is not defined, the system will return an 
error status when you use GIOS function (4,35) to define a graphics character 
set. 

The system default Space character’s vector list pointed by the 32nd entry of 
the system’s Pointer Table is defined as follows: 


CHAR32 DB 

60 

;XLL Coordinate 

DB 

62 

;YLL Coordinate 

DB 

67 

;XUR Coordinate 

DB 

72 

;YUR Coordinate 

DB 

0 

;Last X Byte 

DB 

0 

;Last Y Byte 


The other non-zero entries in the Pointer Table contain the relative offsets (16 
bit) of the vector lists that re-define the characters. You should remember 
that the offset is relative to the start of the Pointer Table , not an absolute 
offset. 


Once you have defined such a table, you can use GIOS call (4,35) to re-define 
the graphics character set. In that function, you specify the offset and 
segment addresses of the first entry of the Pointer Table. (Remember: this 
first entry represents ASCII code 0. You must have 32 null pointers at the top 
of your list, and again in entries 128 through 159.) The Pointer Table and the 
Vector List Table must reside in the same 64K block of memory. 
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Programming Considerations 


When creating graphics characters, you do not have to set the values of 
(XLL,YLL) and (XUR,YUR) to the corresponding values of the ’Space character 
cell For example, to implement proportional spacing within graphics text, you 
might define some characters to be wider and others narrower than the standard 


cell size. 


In fact, the values of (XLL,YLL) and (XUR,YUR) are used only for placing 
characters next to each other on the display. The base line of all of the 
characters in a text string will be aligned. 


Finally, if you replace the entire character set, remember that the offsets 
stored in the Pointer Table must specify an offset relative to the start of the 
Pointer Table , not an absolute offset ! 


NOTE | 


The numbers (coordinates) used in this section are basically 
what the HP 150 uses to generate graphics characters. However, 
if you want to build characters precisely the way you want them 
to appear on the screen, you may have to experiment with the 
data in the character vector lists. 
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Define User Character Set 

This function lets you re-define the entire graphics character set. All 
subsequent graphics text operations will use this character set. This includes 
text size, orientation, slant, and justification. 

Input Buffer : 

(**»35) Function Code 

((TABLE)) Segment and offset address of the table that 

points to the Vector Lists of characters. 

First Word = Offset 
Second Word = Segment 

Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

The previous pages contain information on defining a user character set with a 
Pointer Table and a Vector List Table. 
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Select Default Character Set 

This function sets the character set to the default set maintained by the 
system. The cell size is 7 x 10. 


Input Buffer: 


(U,36) 

Function Code 

Outputs: 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 
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Output Single Text Character 

This function outputs a single graphics character defined by a vector list. All 
current graphics text operations such as size and orientation apply. 


Input Buffer : 

(U,37) 

((CHARACTER)) 


Outputs : 


AX = 0 
AX <> 0 


Function Code 

Segment and offset address of the vector list 
of a single character. 

First Word = Offset 
Second Word = Segment 


Successful 

Unsuccessful 


Remarks : 

The previous pages contain information on creating and outputing graphics 
characters. 


Example : 

The following 8088 assembly program segment outputs the single character defined 
earlier in the section on Building a Character. 

Build the input buffer. 


IN BUF DW 0U37H 

;store function code first 

DW CHAR 

;offset address of the character 

DW 0 

;Assume segment address=0 

;Set up registers to call GIOS. 

;Assume buffer’s segment address 

is already in DS. 

MOV AX,UU03H 

;I/0 control write 

MOV BX,1 

;Console handle 

MOV CX,6 

;# of bytes in buffer 

MOV DX,OFFSET IN BUF 

;input buffer address 

INT 21H 

;output single character 

CMP AX,0 

;check for return status 

JNZ ERROR 

;process error 

RET 

;successful return 


ERROR: 
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Set Graphics Defaults (ESC * m r) 

This function sets the graphics parameters to their default values. 


Input Buffer : 

(4,38) Function Code 

This function affects the following graphics parameters: 
PARAMETER DEFAULT VALUE 


xx-Pen Condition 
xx-Line Type 
xx-Drawing Mode 
xx-User Line Pattern 
xx-Area Fill Type 
xx-User Area Fill Pattern 
xx-Boundary Pen 
xx-Text Size 
x>:-Text Orientation 
xx-Text Origin 
xx-Text Slant 
xx-Graphics Text 

Relocatable Origin 
Graphics Display 
Graphics Cursor 
Graphics Cursor Address 
Rubberband Line 


DOWN 

1 (solid) 

2 (SET) 

255,1 

2 (user-defined pattern) 
255,255-...(solid) 

OFF 

1 

1 

1 (left bottom) 

0 (OFF) 

OFF 

0,0 

ON 

OFF 

0,0 

OFF 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks: 

Function (4,72) sets just those xx- parameters to their default values. 

You should initialize the alphanumeric display and cursor to the state you want 
(ON/OFF) with GIOS function (4,5) or (U,6) and function (U,7) or (4,8). 
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GRAPHICS PLOTTING (ESC * p) 


G r ap hic data is made up of vectors (line segments). The HP 150 uses the concept 
o a pen in drawing vector data. When enough parameter bytes (usually X Y 
coordinates) have been received to specify a data point, the pen is moved from 
its current position to the new end point. If the pen is down, a vector will be 
drawn. If the pen is up, the pen is moved to the new point (without drawing a 
vector) and lowered. In either case, the new point becomes the current pen 
position . -—*■— 


Current Pen Position 


Current pen position is specified in one of the following formats: 

A i*^? LUTE: The value in the absolute format can range from -I638U to 

I6383. Note that only points where X is in the range from 0 to 511 and Y is in 
the range from 0 to 3^9 will be visible on the screen. 


INCREMENTAL: The values in the incremental format are added to the current pen 
position to obtain a new end point. 


RELOCATABLE: The relocatable format allows you to use the relocatable origin 
to be added to the X and Y coordinates. The resultant values are then treated 
as absolute coordinates by the terminal. The relocatable format lets you use 
one set of data and drawing commands to display a figure at several different 
positions on the screen by changing the relocatable origin. 
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This section gives the GIOS functions that support graphics plotting. The 
following graphics plotting functions are explained in detail in this section 


Function Code Function 

(U,39) Lift Pen 


(Mo) 

Vector Move, Absolute 

(MD 

Vector Move, Incremental 

(M2) 

Vector Move, Relocatable 

(M3) 

Lower Pen 

(MU) 

Vector Draw, Absolute 

(M5) 

Vector Draw, Incremental 

(4,46) 

Vector Draw, Relocatable 

(4,47) 

Plot to Cursor Position 

(4,48) 

Point Plot 


(4,49) 

Set Relocatable Origin to Current Pen Position 

(“*,50) 

Start Polygonal Area Fill 

(4,51) 

Terminate Polygonal Area Fill 

(4,52) 

Polygon Move, Absolute 

(4,53) 

Polygon Move, Incremental 

(4,54) 

Polygon Move, Relocatable 

(4,55) 

Polygon Draw, Absolute 

(4,56) 

Polygon Draw, Incremental 

(4,57) 

Polygon Draw, Relocatable 

(4,58) 

Lift Boundary Pen 

(4,59) 

Lower Boundary Pen 


Graphics plotting (ESC * p) sequence is described in Appendix D on Graphics 
Control Functions. 
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Lift Pen (ESC * p a) 


This function lifts the pen. 


Input Buffer : 

(4,39) 


Function Code 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

The pen is an imaginary plotting pen. Movement of the pen from the current 
position will not draw a line. 

Functions (4,40), (4,4l), (4,42) let you lift the pen and move it to a specified 
location. 
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Vector Move, Absolute (ESC * p a <x>,<y>) 

This function lifts the pen from the current pen position and moves the pen to 
an absolute coordinate position. The pen is lowered at the end of the 
operation. 

Input Buffer : 


(4,40) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X and Y numbers give an absolute coordinate 
position in the range from -16384 to +16383. 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



Although the X-COORD a~d Y-COORD parameters can be in the range from -16384 to 
+I6383, only points where X-COORD is in the range from 0 to 511 and Y-COORD is 
in the range from 0 to 389 will be visible on the screen. 
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Vector Move, Incremental (ESC * p a <x>,<y>) 

This function lifts the pen from the current pen position and moves the pen to 
an incremental coordinate position. The pen is lowered at the end of the 
operation. 


Input Buffer : 

(Mi) 

(X-COORD) 

(Y-COORD) 

Outputs : 

AX = 0 
AX <> 0 


Function Code 

The X and Y numbers give an incremental coordinate 
position in the range from -32768 to + 32767 . 


Successful 

Unsuccessful 


Remarks : 

This function adds X-COORD and Y-COORD to the current pen position to obtain a 
new pen position. 


5-65 








GIOS Function Reference 


Vector Move, Relocatable (ESC * p a <x,y» 



This function lifts the pen and moves the pen to a relocatable coordinate 
position. The pen is lowered at the end of the operation. 

Input Buffer : 


(4,42) 


Function Code 


The X and Y numbers are a relocatable coordinate 
position in the range from -32768 to +32767* 


(X-COORD) 

(Y-COORD) 


Remarks: 


This function adds the relocatable origin to the incoming X-COORD and Y-COORD 
values. The resultant values are then treated as absolute coordinates. 

If a relocatable origin has not been defined, the default relocatable origin 
(0,0) is used. You can use function (4,26), (4,27), (4,28), or (4,49) to define 
a relocatable origin. 
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Lower Pen (ESC * pb) 

This function lowers the pen. 

Input Buffer : 

(^,^3) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

Functions (U,UU), (U,U5), (U,U6) let you lower the pen and draw a vector to a 
specified location. 








GIOS Function Reference 


Vector Draw, Absolute (ESC * p b <x>,<y» 

This function lowers the pen and draws a vector to the coordinate position. The 
pen is lowered at the end of the operation. 


Input Buffer: 


(4,4U) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X and Y numbers give the absolute coordinates of the 
vector position. They are in the range from -I 638 U to 
+16383. 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



Note that only points where X-COORD is in the range 0 to 511 and Y-COORD is in 
the rsinge from 0 to 389 will be visible on the screen. 
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Vector Draw, Incremental (ESC 


* p b <x>,<y» 


This function lowers the pen and draws a vector to the incremental coordinate 
position. The pen is lowered at the end of the operation. 


Input Buffer : 

(M5) 

(X-COORD) 

(Y-COORD) 


Outputs : 


AX = 0 
AX <> 0 


Function Code 

The X and Y numbers give the incremental coordinates of 
the vector position. They are in the range from -32768 
to +32767. 


Successful 

Unsuccessful 


Remarks: 


This function adds X-COORD and Y-COORD to the current pen position to obtain a 
new pen position. 
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Vector Draw, Relocatable (ESC * p b <x>,<y>) 

This function lowers the pen and draws a vector to the relocatable coordinate 
position. The pen is lowered at the end of the operation. 

Input Buffer : 


(U, U6) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X and Y numbers give the relocatable coordinates of 
the vector position. They are in the range from -32768 
to +32767. 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function adds the relocatable origin to the incoming X-COORD and Y-COORD 
values. The resultant values are then treated as absolute coordinates. 


If a relocatable origin has not been defined, the default relocatable origin 
(0,0) is used. You can use function (U,26), (U,27), (U,28), or (U,l+9) to define 
a relocatable origin. 
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Plot to Cursor Position (ESC * p c) 

This function moves the pen from its current position to the current cursor 
position if the pen is up. A draw is performed from the current pen position to 
the current cursor position if the pen is down. 

Input Buffer : 

(*♦>*♦7) Function Code 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 
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Point Plot (ESC * p d) 

This function draws a dot at the current pen position and then lifts the pen. 


Input Buffer : 

(U,U8) 

Outputs : 

AX = 0 
AX <> 0 


Function Code 


Successful 

Unsuccessful 
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Set Relocatable Origin to Current Pen Position (ESC * p e) 

This function sets the relocatable origin to the current pen position. 
Input Buffer : 

Function Code 


(M9) 


Outputs : 

AX = 0 
AX <> 0 



Successful 

Unsuccessful 
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Start Polygonal Area Fill (ESC * p s) 

This function starts polygonal area fill. The boundary pen is lowered with this 
function. 

Input Buffer : 

(4,50) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks : 

You can define a polygon with as many as 105 sides. This function causes 
subsequent coordinate pairs to be read as vertices of the polygon. When a lift 
pen command (function (4,39)) occurs in the middle of a polygon area fill 
function, a new polygon is started. The Terminate Area Fill command (4,51) 
causes the polygon to be filled using the current drawing mode and area pattern. 



Figure 5-8. Polygon Area Fill Example 

If the polygon definition crosses over itself, the areas are defined in 
alternate order. 



Figure 5 - 9 . Overlapping Pvxygon Area Fills 
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The only graphics functions allowed between Start Polygon Area Fill function 
(4,50) and Terminate Polygon Area Fill function (4,51) are: 

Lift Pen: (4,39) 

Lower Pen: (4,43) 

Plot to Cursor Position: (4,47) 

Set Relocatable Origin to Current Pen Positxon: (4,49) 

Polygon Move functions: (4,52), (4,53), (4,54) 

Polygon Draw functions: (4,55), (4,56), (4,57) 

Lift Boundary Pen function: (4,58) 

Lower Boundary Pen function: (4,59) 

Any other functions will terminate the polygon area fill function. 

Example : 

This example lists the procedural steps to draw a triangle at locations (10,10), 
(20,10), and ( 15 , 20 ) with area fill pattern 5> and with boundary pen enabled: 


( 15 , 20 ) 



(10, 10) (20, 10) 


The procedural steps to execute the polygonal area fill is listed below: 

1 . Select polygonal fill pattern 5 using function (4,23) 

2. Start polygonal area fill using function (4,50) 

3. Move to point (10,10) using function (4,52) 

4. Draw to point (20,10) using function (4,55) 

5. Draw to point (15,20) using function (4,55) 

6. Terminate polygonal area fill using function (4,51) 

Note that it is not necessary to draw to point (10,10) after step 5 because the 
Terminate Polygonal Area Fill function automatically draws from the last point 
( 15 , 20 ) to the first point (10,10). 
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Terminate Polygonal Area Fill (ESC * p t) 

This function closes the current polygon definition and fills the polygon. The 
boundary pen is lifted at the end of this function. 

Input Buffer : 

(U,51) Function Code 

Outputs ; 

AX = 0 Successful 

AX <> 0 Unsuccessful 

Remarks : 

The polygon is not drawn and filled until this function is called. 

It is not necessary to specify a vector from the last point back to the first 
point; this function automatically closes the polygon definition. (See the 
example in the Start Polygonal Area Fill function (U,50) for more details.) 
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Polygon Move, Absolute 

This function closes the polygon defined up to this point and moves the pen to 
the given absolute position to start a new polygon. If the pen is up, it is 
lowered at the end of this function. 

Input Buffer : 

(U,52) 

(X-COORD) 

(Y-COORD) 


Outputs : 

AX = 0 
AX <> 0 


Remarks : 

Although the X-COORD and Y-COORD parameters can be in the range from -16384 to 
+16383, only points in the absolute display region will be visible on the 
screen. That is, X-COORD is in the range from 0 to 511 and Y-COORD is in the 
range from 0 to 389. 

Polygon move is used at the start of a polygon and can be used in the middle to 
draw more complex polygons with "islands". 

«*#»«*« See ^ exajnple Q f this function on the next page ******* 


Function Code 

The X and Y numbers give the absolute coordinates of the 
new position. They are in the range from -16384 to 
+16383. 


Successful 

Unsuccessful 







GIOS Function Reference 


Example : 

The following example lists the procedural steps to draw a triangle inside a 
rectangle using polygon move functions (4,52), (4,53)» or (4,54), ^8 polygon 
draw functions (4,55), (4,56), or (4,57). The area outside of the triangle is 
filled with the currently defined area-fill pattern. The boundary pen is 
assumed to be enabled. 



The steps to generate the above figure is listed below: 

1. Start polygonal area fill using (4,50) 

2. Move to point 1 using (4,52) 

3. Draw to point 2 using (4,56) 

4. Draw to point 3 using (4,56) 

5. Draw to point 4 using (4,56) 

6. Move to point 5 using (4,52) 

7. Draw to point 6 using (4,56) 

8. Draw to point 7 using (4,56) 

9. Terminate polygonal area fill using (4,51) 

Note that it is not necessary to draw to point 1 from point 4 after step 5. 
Move polygon function automatically closes the rectangular polygon. 
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Polygon Move, Incremental 

This function closes the polygon defined up to this point and moves the pen to 
the given incremental coordinate position to start a new polygon. If the pen is 
up, it is lowered at the end of this function. 


Input Buffer: 


(U,53) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X and Y numbers give the incremental coordinates of 
the new position. They are in the range from -32768 to 
+32767. 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function adds X-COORD and Y-COORD to the current pen position to obtain a 
new pen position. 








GIOS Function Reference 


Polygonal Move, Relocatable 

This function closes the polygon defined up to this point and moves the pen to 
the given relocatable coordinate position to start a new polygon. If the pen is 
up, it is lowered at the end of this function. 

Input Buffer ; 


(U,5U) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X and Y numbers give the relocatable coordinates of 
the new position. They are in the range from -32768 to 
+32767- 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function adds the relocatable origin to the incoming X-COORD and Y-COORD 
values. The resultant values are then treated as absolute coordinates. 

If a relocatable origin has not been defined, this function uses the default 
relocatable origin (0,0). You can use function (4,26), (4,27), or (4,28) to 
define a relocatable origin. 
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Polygon Draw, Absolute 

This function defines the edge of a polygon from the current pen position to the 
given absolute coordinate position. 

Input Buffer ; 

(U,55) 

(X-COORD) 

(Y-COORD) 


Outputs : 

AX = 0 
AX <> 0 


Remarks: 

Note that only points where X-COORD is in the range from 0 to 511 and Y is in 
the range from 0 to 389 will be visible on the screen. 

You can use polygon move and draw functions to draw more complex polygons. 
Remember, the polygon is not drawn until the Terminate Polygonal Area Fill 
function (U,51) is called. (See an example of a polygon with an "island" in 
function (U,52)). 




Function Code 

The X and Y numbers give the absolute coordinates of the 
new position. They are in the range from -I 638 U to 

+ 16383 . 


Successful 

Unsuccessful 
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Polygon Draw, Incremental 

This function defines the edge of a polygon from the current pen position to the 
given incremental coordinate position. 


Input Buffer: 


(4,56) 

Function Code 

(X-COORD) 

(Y-COORD) 

The X sind Y numbers give the incremental coordinates of 
the new position. They are in the range from -32768 to 
+32767. 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 

Remarks: 



This function adds X-COORD and Y-COORD to the current pen position to obtain a 
new pen position. 

Remember, the polygon is not drawn until the Terminate Polygonal Area Fill 
function (U, 51 ) is called. 
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Polygon Draw, Relocatable 

This function defines the edge of a polygon from the current pen position to the 
given relocatable coordinate position. 

Input Buffer : 


(U,57) 


Function Code 


(X-COORD) 

(Y-COORD) 


The X and Y numbers give the relocatable coordinates of 
the new position. They are in the range from -32768 to 
+32767. 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

This function adds the relocatable origin to the incoming X-COORD and Y-COORD 
values. The resultant values are then treated as absolute coordinates. 

Remember, the polygon is not drawn until the Terminate Polygonal Area Fill 
function (U, 51 ) is called. 
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Lift Boundary Pen (ESC * p u) 

This function lifts the polygon boundary ^n. Edges of the polygon are not 
drawn. This remains in effect until the boundary pen is lowered. 

Input Buffer ; 

(4,58) Function Code 

Outputs : 

AX = 0 
AX <> 0 

Remarks : 

GIOS function (4,59) lets you lower the boundary pen. 


Successful 

Unsuccessful 


Example : 


The procedural steps to generate the following figure is listed below: 


/////////// 
'//////////// 
/ss///////// 
//////////// 
//////////// 
'//////////// 
'//////////// 
/ / / / / K / / / / / / 

/ / / / / \ / / / / / 

///// \/ / / / / 

/ / / / \ / / / z 

/// \///s 

/ / / \ / / / 
' / / > 7 > > " 7 " 
'//Z///////// 
////////// / / 


1. Enable polygon boundary pen, using (4,24). 

2. Start polygonal area fill, using (4,50). 

3. Move to point A, using (4,52). 

4. Draw to point B, using (4,56). 

5. Lift boundary pen, using (4,58). 

6. Draw to point C, using (4,56) 

7. Draw to point D, using (4,56). 

8. Lower boundary pen, using (4,59)* 

9. Lift pen, using (4,39)- 

10. Move to point E, using (4,52). 

11. Draw to point F, using (4,56). 

12. Draw to point G, using (4,56). 

13. Lift boundary pen, using (4,59). 

14. Terminate polygonal area fill, using (i. ^l). 


Step 10 moves the pen to point E and then lowers the pen; therefore, you do not 
have to specifically lower the pen 


The following assembly program implements Che above procedure: 
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This example uses GIOS functions to draw a triangle inside a rectangle. 
The GIOS functions used are Start Polygonal Area Fill, Lift and Lower 
Pen, Lift and Lower Boundary Pen, Polygonal Move and draw, and 
Terminate Polygonal Area Fill. 


DATA SEGMENT 

9 

;Build input buffers for the series 
» 

CMD_BUF DB 3,1+ 

;Enable the boundary pen. 

9 

DB 24,1+ 

DW 0 

;Select area fill pattern. 

DB 23,4 

DW 4 

;Start polygonal area fill. 


;start data segment 
of AGIOS functions. 

;function code - graphics display on 

;function code - enable boundary pen 
;pen number 


;function code - select fill pattern 
;select pattern 4 


50,4 ;function code - start polygon area fill 


;Move to point A (100,100) of the rectangle. 

DB 52,4 

;function code - absolute code 

DW 100 

;X coordinate 

DW 100 

;Y coordinate 

;Draw to point B (200,100) of the rectangle. 

DB 56,4 

function code - incremental draw 

DW 100 

X coordinate (right 100 pixels) 

DW 0 

Y coordinate (no change) 

;Lift up the boundary pen. 


DB 58,4 

;function code - lift boundary pen 

;Draw to point C (200,250) of the rectangle. 

DB 56,4 

function code - incremental draw 

DW 0 

X coordinate (no change) 

dw 150 

Y coordinate (up 150 pixels) 

Draw to point D (100,250) of the rectangle. 

DB 56,4 

function code - incremental draw 

DW -100 

X coordinate (left 100 pixels) 

DW 0 

Y coordinate (no change) 
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;Lower the boundary pen. 




DB 

59, U 

;function code 

- lower boundary pen 

;Lift the drawing pen. 




DB 

39, 

;function code - 

lift drawing pen 


;Move to point E (125,125) of the triangle. Remember, this operation 
;lowers the pen. 


* 

DB 

52 , 4 


;function code - absolute move 


DW 

125 


;absolute X coordinate 


DW 

125 


;absolute Y coordinate 

;Draw to point 

F (175,125) Of 

the 

triangle. 


DB 

56 , 4 


;function code - incremental draw 


DW 

50 


;X coordinate (right 50 pixels) 


DW 

0 


;Y coordinate (no change) 

* 

;Draw to point 

G (150,175) of 

the 

triangle. 

* 

DB 

56 , 4 


;function code - incremental move 


DW 

-20 


;X coordinate (left 20 pixels) 


DW 

50 


;Y coordinate (up 50 pixels) 

* 

;Lift the boundary pen. 




* 

DB 

58 ,4 


;function code - lift boundary pen 

* 

;Terminate the polygonal area 

fill. 

* 

DB 

51,■U 


;function code - terminate fill 


Use the batch function (0,0) to execute all the functions defined in 
the buffers above in the data segments. 


Build the batch command buffer. 


BATCH 

DB 

0,0 

;Batch function code 

BUF LEN 

DW 

64 

;command buffer length 

CMD OFFSET 

DW 

CMD BUF 

;command buffer offset address 

CMD_SEG 

DW 

0 

;allocoate a word to store 




; command buffer segment address 

DATA 

ENDS 


;end of data segment 

y 

;start program 

segment. 



CODE 

SEGMENT 


;start code segment 


ASSUME 

CS:CODE, 

DS:DATA 


Initialize data segment. 
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START: 

MOV 

AX,DATA 

;set up data segment register 


MOV 

DS ,AX 


MOV 

CMD_SEG,AX 

;store segment in command buffer 


;Set up entry registers to call AGIOS batch function (0,0). 
;DS register is already set up. 


AX,UU03H ;I/0 control write 

BX,1 ;console handle 

CX»8 ;input buffer length 

DX, OFFSET BATCH ;input buffer offset address 

21H 


AH,4CH ;MS-DOS function UCH lets 

21H ; return to MS-DOS gracefully 

;end of code segment 
START ;end of program 


AGIOS: MOV 

MOV 
MOV 
MOV 
INT 

* 

;Return to MS-DOS. 

* 

MOV 

INT 

CODE ENDS 

END 








GIOS Function Reference 


Lower Boundary Pen (ESC * p v) 

This function lowers the polygon boundary pen. If a boundary pen has been 
enabled, edges of the polygon are drawn with a solid line pattern regardless of 
the current defined line type. This remains in effect until the boundary pen is 
lifted. 

Input Buffer : 

(U, 59 ) Function Code 

Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


Remarks : 

The boundary pen is not selected by default. You can select or enable the 
boundary pen using function (U,24). 

(See an example on lifting and lowering boundary pen in function (U,58).) 
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GRAPHICS STATUS (ESC * s) 


The GIOS functions in this section let you request graphics status information. 
There are twelve graphics statuses and each can be requested with the 
appropriate function. The information is returned in the buffer specified by 
the segment and offset address given in your application. 

This section gives the GIOS functions that return graphics status information. 
The following graphics status functions are explained in detail in this section: 

Function Code Function 


(Mo) 
(MU 
(M2) 
(M3) 
(4,64) 
(M5) 
(M 6) 
(**,67) 

(4.68) 

(4.69) 

(4.70) 

(4.71) 

(4.72) 

(4.73) 

(4.74) 


Not Implemented 

Read Pen Position 

Read Cursor Position 

Not Implemented 

Read Display Size 

Read Graphics Settings 

Read Graphics Text Status 

Read Zoom Status 

Read Relocatable Origin 

Read Reset Status 

Read Area Shading 

Read Dynamic Graphics Capabilities 

Set Picture Definition Defaults 

Graphics Hard Reset 

Read Extended Screen Dimensions 


Graphics Status (ESC * s) 
Control Functions. 


sequences are described in 


Appendix D on Graph 


ics 


5-89 








GIOS Function Reference 


Read Pen Position (ESC * s 2 A ) 

This function returns the current position and the state of the pen 


Input Buffer: 


(4,61) 

Function Code 

((BUFFER)) 

Segment and offset address of a 3-word buffer for 
returning pen status position. 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains 


(X-COORD) 

(Y-COORD) 

The X and Y coordinates of the current pen 
position. 

(STATE) 

0 = Pen lifted 

1 = Pen lowered 
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Read Cursor Position (ESC * s 3 A ) 

This function returns the current position of the cursor. 


Input Buffer: 


(4,62) 

Function Code 

((BUFFER)) 

Segment and offset address of a 2-word buffer 
for returning the cursor position. 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains: 

(X-COORD) 

(Y-COORD) 


The X and Y coordinates of current cursor 
position. 
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Read Display Size (ESC * s 5 A ) 

This function returns the number of displayable units in the X and Y axes. It 
also returns the number of units per millimeters in the display. 


Input Buffer: 


<U,64) 

Function Code 

((BUFFER)) 

Segment and offset address of a 6-word buffer for 
returning the display size and unit. 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains 


(X-LWR-LEFT) 

(Y-LWR-LEFT) 

Lower left X and Y coordinates of the maximum 
display size. 

(X-UPR-RIGHT) 

(Y-UPR-RIGHT) 

Upper right X and Y coordinates of the maximum 
display size. 

(X-MM) 

(Y-MM) 

The X and Y dimensions in number of dots per 
millimeter. 

Remarks: 



This function lets you scale data for use on graphics devices with varying 
display area size. 

X-MM and Y-MM can be used to determine the Aspect Ratio of the graphic pixels 
Aspect Ratio = Y-MM/X-MM 
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Read Graphics Settings (ESC * s 6 A ) 


This function returns information about the current active graphics settings. 
Input Buffer : 

(4,65) Function Code 


((BUFFER)) 


Outputs : 

AX = 0 
AX <> 0 


Segment and offset address of a 16-word buffer for 
returning graphics settings. 

First Word = Offset 
Second Word = Segment 


Successful 

Unsuccessful 


BUFFER contains the following graphics settings in 16 consecutive words. 


1. (CLEAR DISPLAY) 

2. (NUMBER OF PENS) 

3. (COLOR CAPABILITY) 

4. (COLOR LEVEL CAPABILITY) 

5. (AREA SHADING) 

6. RESERVED 

7. RESERVED 

8. (DYNAMIC MODIFICATION) 

9. (CHARACTER SIZE) 


0 = No clear 

1 = Paper advance 

2 = Clear (total erase) 

*3 = Partial clear by area 

*1 

*0 = Black or green 
1 = Gray levels 

*0 = No color 

0 = No 
*1 = Yes 

0 

0 

0 = No 
*1 = Yes 

0 = Fixed 

1 = Integer multiples of the basic 
cell size 

*2 = Fractional scale of the basic 
cell size 
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10. (CHARACTER ORIENTATION) 


11. (CHARACTER SLANT) 


12. (DOT-DASH LINE PATTERNS) 


13. (RESERVED) 

14. (RESERVED) 

15. (RESERVED) 

1 6 . (RESERVED) 


0 = Fixed 

*1 = Multiples of 90 degrees 

2 = Multiples of 45 degrees 

3 = Any angle 

0 = Fixed 

*1 = 26.57 degrees 
2 = Any angle 

0 = None 

1 = Pre-defined only 
*2 = User-defined and predefined 

*0 

*0 

*0 

*0 


| NOTE ~~| 


* Indicates the value that the HP 150 always returns. 
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Read Graphics Text Status (ESC * s 7 A ) 

This function returns the current attributes of graphics text. 


Input Buffer: 


(M6) 

Function Code 

((BUFFER)) 

Segment and offset address of a 5~word buffer for 
returning graphics attributes. 

First Word = Offset 

Second Word = Segment 

Outputs: 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains 


(X SIZE) 

(Y SIZE) 

The X,Y dimensions of the character cell. 

(ORIGIN) 

The text origin (0-11) 

(ORIENTATION) 

The text orientation (0, 90, 180, 270) 

(SLANT) 

The character slant. 


0 = Not slanted 
27 = Slanted 
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Read Zoom Status (ESC * s 8 


A ) 



This function returns the terminal’s zoom setting. 


Input Buffer : 

(U,67) 

((BUFFER)) 


Outputs : 

AX = 0 
AX <> 0 


Function Code 

Segment and offset address of a 2-word buffer 
for returning the zoom setting. 

First Word = Offset 
Second Word = Segment 


Successful 

Unsuccessful 


BUFFER contains: 
(ZOOM SIZE) 
(ZOOM ON/OFF) 


1 

0 

1 


16 (the HP 1 

OFF (the HP 
ON 


.^0 always returns 1). 
150 always returns 0) 
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Read Relocatable Origin (ESC * s 9 A ) 

This function returns the current relocatable origin. 


Input Buffer: 


(4,68) 

Function Code 

((BUFFER)) 

Segment and offset address of a 2-word buffer 
for returning the relocatable origin. 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains 


(X-COORD) 

(Y-COORD) 

The X and Y coordinates of the current relocatabli 
origin. 
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Read Reset Status (ESC * s 10 A ) 

This function returns information on whether the terminal has executed a full 
reset (or power on) since the last time reset status was checked. 

Input Buffer : 


(U,69) 

Function Code 

((BUFFER)) 

Segment and offset address of a 8-word buffer for 
returning reset status. 

First Word = Offset 

Second Word = Segment 


Outputs 


AX = 0 

AX <> 0 

Successful 

Unsuccessful 


BUFFER contains 


(RESET STATUS) 

0 = no full reset since last check 

1 = terminal has been reset 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 


Remarks: 



This function tells whether or not you need to re-establish terminal settings or 
images before resuming terminal functions. 

You will need to allocate 7 additional words to BUFFER, but they are currently 
not used. 
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Read Area Shading (ESC * s 11 A ) 


This function returns information 


on the terminal’s area shading capability. 


Input Buffer : 

(4,70) Function Code 

((BUFFER)) Segment and offset address of a 3 _ word buffer for 

returning shading information. 


First Word = Offset 
Second Word = Segment 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


BUFFER contains: 

(CAPABILITIES) The area shading capabilities (the HP 150 always 
returns "2" to indicate that the area shading can 
be a polygon). 

(WIDTH) The area shading pattern size (the HP 150 always 

(HEIGHT) returns "8" for WIDTH and "8” for HEIGHT). 
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Read Dynamic Graphics Capabilities (ESC * s 12 A ) 

This function returns information on the terminal’s dynamic graphics 
capabilities. 

Input Buffer : 

(4,71) Function Code 

((BUFFER)) Segment and offset address of a 2-word buffer for the 

returning dynamic graphics capabilities. 


First Word = Offset 
Second Word = Segment 


Outputs : 

AX = 0 Successful 

AX <> 0 Unsuccessful 


BUFFER contains: 

(SELECTIVE-ERASE-CAPABILITIES) 
(COMPLEMENT-CAPABILITIES) 


The HP 150 always returns a "1". 
The HP 150 always returns a ”1". 


Remarks : 

This funcxion returns the ability of the terminal to change selected portions of 
the display. The HP 150 has selective erase and complement capabilities. 


5-100 







GIOS Function Reference 


Set Picture Definition Defaults (ESC * m 1 r) 

This function sets the picture definition parameters to their default values. 
Input Buffer : 

(U,72) Function Code 


(RESET LEVEL) 


Outputs : 

AX = 0 
AX <> 0 


The level of graphics reset. On the HP 150, the 
"1" is the only supported level. 


value 


Successful 

Unsuccessful 


The picture defaults are: 

Pen (DOWN) 

Line type (1) 

User-defined line pattern (SOLID) 
User-defined area fill pattern (SOLID) 
Boundary pen (OFF) 

Drawing mode (SET) 

Text size (1) 

Text origin (1) 

Text slant (OFF) 

Text orientation (1) 

Graphics text (OFF) 

Area fill type (2) 


Remarks : 

Function (U, 38 ) lets you set all the graphics parameters to their default 
values. 
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Graphics Hard Reset (ESC * w r) 


This function sets the graphics parameters to their power-on state. 


Input Buffer : 

(U,73) 


Function Code 


Outputs : 


AX = 0 
AX <> 0 


Successful 

Unsuccessful 


Remarks : 

This function sets all graphics parameters to their default values plus the 
following: 

1. Clears raster memory buffer 

2. Drawing pen is positioned at location (0,0) 

3. Sets the graphics character set to the system default character set 

Graphics defaults are listed in function (U,38) which sets graphics 
parameters to their default values. 
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Read Extended Screen Dimensions 


This function provides information about the alphanumeric 
and graphics screen size plus the relationship between the two. 

Input Buffer : 

(*♦*7*0 Function Code 

((BUFFER)) Segment and offset address of a 10-word buffer 

for returning screen dimensions. 

First Word = Offset 
Second Word = Segment 

Outputs : 


AX = 0 Successful 

AX = 0 Successful 

BUFFER contains: 


Graphics screen size, in pixels : 

(^'PIXELS) 512 in the horizontal direction 

(Y-PIXELS) 390 in the vertical direction 

Alphanumeric screen size, in rows and columns : 

(ROWS) 2k rows. (2k is returned, but 3 more rows 

need to be added for softkey labels and 
status line.) 

(COLUMNS) 80 columns 

Graphics screen size, in millimeters : 

(X-MM) 160 in the horizontal direction 

(Y-MM) 120 in the vertical direction 


Alphanumeric screen size, in millimeters : 

(ROW-MM) 150 in the horizontal direction 

(COL-MM) 116 in the vertical direction 


Graphics origin minus alphanumeric origin, in millimeters : 

(DELTA-X) 10 in the horizontal direction 

(DELTA-Y) k in the vertical direction 
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The HP 150 provides a set of Data Communications (data comm) I/O functions in 
addition to the standard I/O functions available in MS-DOS. This section 
discusses how to write your own data comm programs using the standard MS-DOS 
functions and the HP extended functions. At the end of this section, there is a 
program that uses these data comm functions to read and write data to the data 
comm ports in the HP 150. The program is written in Microsoft compiled BASIC 
and it calls an assembly routine to perform the data comm operations. 


WRITING YOUR OWN DATA COMM PROGRAM 


The HP 150 contains two serial ports, labeled Port 1 and Port 2. To perform 
Input/Output operations on the two serial ports, the HP 150 uses data comm 
devices C0M1 and COM2. This may be different from other computers that use 
hardware port addresses. 

You can write data comm programs using devices C0M1 and COM2. The steps are 
listed below: 

1. Open device C0M1 or COM2 using MS-DOS function 3D hex 

2. Read data from the opened device using MS-DOS function 3F hex 

3. Write data to the opened device using MS-DOS function 40 hex 
U. Perform special operations using MS-DOS I/O function UU hex 

MS-DOS functions 3D hex, 3F hex, UO hex, and hk hex are described in the MS-DOS 
Programmer's Reference Manual. 


NOTE 


The above procedure lets you perform I/O operations on 
serial ports. For information on performing HP-IB I/O 
operations, see the HP 150 Technical Reference Manual 
(Product No. U 5625 A). 
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ASSIGNING COM1 AND COM2 DEVICES 


The HP 150 default device assignments for C0M1 and COM2 are Port 1 and Port 2, 
respectively. The configuration information defined in Port 1 and Port 2 
configuration menus are still in effect. Therefore, your application program 
does not have to set baud-rates, parity, and other data comm parameters. The HP 
150 also handles Enq/Ack or Xon/Xoff handshaking if it is selected, and 
maintains a 256 -byte buffer for incoming data on each serial port; therefore, 
there is less chance for your application to lose data. 

You can change C0M1 and COM2 device assignments in two ways. First, you can use 
the Device Config program under P.A.M. to map either C0M1 or COM2 to Port 1 or 
Port 2 or ’Remote’. If C0M1 or COM2 is mapped to ’Remote’, that device is tied 
to the Remote/Serial field in the Global Configuration menu. Second, the 
Remote/Serial field lets you map either Port 1 or Port 2 to ’Remote’ or 
’Serial’. ’Remote’ is typically a mainframe computer and ’Serial’ is typically 
a line printer. You can change these assignments as necessary by following the 
procedures in "Configuring MS-DOS" in the HP 150 Personal Computer Owner’s 
Guide. 
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ACCESSING SPECIAL DATA COMM FUNCTIONS 


In addition to the standard MS-DOS read and write capabilities, there are some 
additional functions that you can use to control data comm operations. To 
access a data comm function, you have to set up an input buffer. The first word 
in the buffer must be the function code for the desired function. If the 
function requires any additional parameters, they must be stored in the buffer 
in the order that is indicated in the function description. 

Once you have set up the input buffer, you can use MS-DOS I/O control function 
UUH to execute the data comm control function. In order for function UUH to 
execute properly, you have to set up the required assembly registers as listed 
below: 


AX = I/O Control Write (UU03H) 

BX = Data comm device handle 
CX = Number of bytes in the input buffer 
DS = Input buffer segment address 
DX = Input buffer offset address 

The AX register tells the operating system to perform am I/O control write 
operation. The BX register has the device handle. When the operating system 
opens a device, it returns a device handle that is used to identify the device 
in subsequent system function calls. The CX register has the number of bytes in 
the buffer. The buffer is addressed by DS and DX registers. 

Once your application sets up the above registers, it transfers control to the 
operating system by issuing an ’INT 21H’ instruction. The operating system 
always returns a completion status in the carry-flag. If "carry" is clear, then 
the function is successful; otherwise, it is not successful. 

The MS-DOS Programmer 's Reference Manual has additional information on I/O 
function UUH. 
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DATA COMM FUNCTION REFERENCE 


Each Data Comm function is identified by a l6-bit function code as shown below: 
Bit 15 0 

I 8 | X | 


high low 
byte byte 

The operating system uses the high byte of this function code to identify the 
type of control function to perform. For data comm functions, the high byte of 
the function code is always the value 8. The low byte of the function code is a 
function number that tells the operating system which data comm function to 
execute. Your application must store this 2-byte function code in the first 
word of an input buffer to be passed to the operating system. 


In this section, a data comm function code is given in decimal and is 
respresented by an ordered-pair (8 ,X). You should note that the Intel processor 
interprets the two bytes in a word in reverse order; that is, in physical 
memory, the value X is stored before the value 8. There are two ways of 
defining a function code; you can define it either in byte-mode or in word-mode 
using the Micro-Soft Macro-Assembler directives Define Byte (DB) or Define Word 
(DW). 


For example, to allocate a buffer called IN_BUF and store the function code 
(8,1) in the first word of IN_BUF, you can use either one of the following 
instructions: 


For example, to allocate a buffer called IN_BUF and store the function code 
(8,1) in the first word of IN_BUF, you can use either one of the following 


instructions: 




In Byte-mode: 

IN_BUF 

DB 

1,8 

In Word-mode: 

IN BUF 

DW 

0801H 


The above two instructions both allocate a buffer called IN_BUF and store the 
value 1 in the first byte and the value 8 in the second byte of the buffer. 

In order to clarify the parameters your application needs to supply, a standard 
notation is used in the function reference. A single-parenthesis notation 
indicates a l6-bit parameter and a double-parenthesis notation indicates a 
double-word parameter. 
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The following data comm functions are described in detail in this section 


Function Code 

Function 

(8,1) 

(8,2) 

(8.3) 

(8.4) 

(8.5) 

(8.6) 

(8,7) 

Set 7-bit Mode 

Set 8-bit Mode 

Enable Transparency Mode 

Disable Transparency Mode 
Disconnect Modem 

Send Break 

Send Data Block 




Data Communications Programming 


Set 7-Bit Mode 

This function turns on 7-bit mode. In this mode, your application works with 
the first 7 bits of each data comm byte. The system firmware assumes the eighth 
bit is the parity bit and interprets it according to the Parity setting in the 
Portl or Port2 Configuration menu. Any selected handshaking is still active. 
This is the default (power-on) mode of operation for data comm devices. 

Input Buffer : 

( 8 , 1 ) 


Outputs : 

Carry = 0 
Carry = 1 

Example : 

The following assembly program segment sets up the required parameters and calls 
MS-DOS to turn on 7~bit mode for C0M1 


;Build an input buffer with the correct function code stored 
; in it. 

* 

IN_BUF DB 1,8 ;function code to turn on 7~bit mode 

C0M1_HAN DW ? ;allocate space to store device handle 


Function Code (1 word) 

Most significant byte = 8 
Least significant byte = 1 


Successful 

Unsuccessful 


Set up the required registers. The input buffer’s segment 
address is assumed to be the same as the current DS register. 
The C0M1 device handle is already stored in C0M1_HAN. 


MOV 

AX,UU03H 

MOV 

BX,C0M1 HAN 

MOV 

CX,2 

MOV 

DX, OFFSET : 

INT 

21H 

RET 



I/O control write 
BX = C0M1 handle 
2 bytes in the buffer 
pass buffer offset address 
transfer control to MS-DOS 
return 
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Set 8-Bit Mode 


This function turns on 8-bit mode. In this mode, your application works with 
all eight bits of each data comm byte. Any selected handshaking is still 
active. Depending on the current settings in the Portl or Port2 Configuration 
menu, control codes (such as DC1, ACK, ENQ, NULL, DEL, etc.) may be interpreted 
by the system firmware. 

Input Buffer : 

(8,2) Function Code (1 word) 


Most significant byte = 8 
Least significant byte = 2 


Outputs : 


Carry = 0 
Carry = 1 


Successful 

Unsuccessful 
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Enable Data Comm Transparency Mode 

This function sets data comm transparency mode. In this mode, handshaking is 
disabled and all characters are passed directly to your application. The HP 150 
system firmware does not process data comm characters. 


Input Buffer: 


(8,3) 

Function Code (1 word) 

Most significant byte = 8 

Least significant byte = 3 


Outputs 


Carry = 0 
Carry = 1 

Successful 

Unsuccessful 

Remarks: 



Even though handshaking is disabled in transparency mode, the HP 150 processes 
Xon/Xoff handshaking if it is enabled. 

You can specify this function independent of 7 _ bit mode or 8-bit mode functions 
(8,1) and (8,2), respectively. 
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Disable Data Comm Transparency Mode 


This function disables data comm transparency mode. In this mode, the handshake 
options selected in Portl or Port2 configuration menus are active. The system 
firmware monitors the data coming in and out of the selected data comm device. 
Control characters (such as DC1, ACK, ENQ, NULL, and DEL) are interpreted and 
absorbed by the system firmware. 

Input Buffer ; 

(8,U) Function Code (1 word) 


Most significant byte = 8 
Least significant byte = U 


Outputs : 


Carry = 0 
Carry = 1 


Successful 

Unsuccessful 


Remarks: 



This is the default mode of operation for Data Comm devices. 
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Disconnect Modem 

This function drops the Device Terminal Ready (DTR) hardware signal which causes 
a modem disconnect. 

Input Buffer : 

(8,5) 

Outputs : 

Carry = 0 
Carry = 1 

Remarks : 

This function is designed to disconnect a modem from an application running 
under MS-DOS. The escape sequence ESC f disconnects the modem in Terminal mode; 
it does not work in Computer mode. 


Function Code (1 word) 

Most significant byte = 8 
Least significant byte = 5 


Successful 

Unsuccessful 
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Send Break 

This function is equivalent to typing the Break key from the keyboard in 
Terminal mode. The system firmware does it by holding the hardware transmit 
line low for 200 milliseconds. 


Input Buffer : 
( 8 , 6 ) 


Function Code (1 word) 

Most significant byte = 8 
Least significant byte = 6 


Outputs : 


Carry = 0 
Carry = 1 


Successful 

Unsuccessful 


Remarks: 


This function is designed to send a ’break’ to your application 
programmatically. The Break key on the keyboard only works in Terminal mode; it 
does not work in Computer mode. That is, you cannot use the Break key to abort 
an application currently running under MS-DOS. 
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Read/Write Data Comm Blocks 

The HP 150 system firmware, while offering a very high level of functionality, 
can also operate at high speed if Input and Output operations are performed on 
blocks of characters instead of one character at a time. When using data comm, 
there are special multiple-character read said write functions that can 
significantly improve performance. 

For block output, an application can use function (8,7) to write a block of data 
to a data comm port. Function (8,7) is described in detail in the next section. 
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Send Data Block 

This function sends one block of data at a time to the selected data comm device 
rather than transmitting one byte at a time. Data is stored in a buffer 
specified by your application. There is no system limit on the buffer size, 
except that the buffer length should not be too big to fit in the DATA LENGTH 
parameter. 


Input Buffer : 

(8,7) 

((BUFFER)) 


(DATA LENGTH) 


Function Code (1 word) 

An address that points to the data 
buffer (2 words). 

First Word = Offset address 
Second Word = Segment address 

A word that contains the number of bytes 
in the data buffer. 


The following diagram shows how the input buffer should look: 


Bit 15 87 0 

First Word 
Second Word 
Third Word 
Fourth Word 


+ - + 

18 17 1 


Buffer Offset 


Buffer Segment 


Data Length 


Outputs : 

Carry = 0 Successful 

Carry = 1 Unsuccessful 

Remarks : 

This function is similar to the standard MS-DOS Write function (LOH) except that 
it takes less time to send a block of data. 

«**«*«# g ee ^ exam pi e Q f this function on the next page ******* 
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Example : 

The following assembly program segment calls function (8,7) to send the string 
’HELLO’ to device C0M1. It assumes that device C0M1 is already opened and the 
device handle is stored in C0M1 HAN. 


Build an input buffer with the required parameters stored in it. 
The parameters must be stored in the order that is specified in 
the function description. 


IN_BUF 

DW 

0807H 

;send data block function code 


DW 

DATA_OFF 

;the offset address of data block 

DATA_SEG 

DW 

7 

;the segment address of data block 


DW 

5 

; (to be assigned) 

;5 bytes in data block 

DATA OFF 

DB 

’HELLO’ 

;define the string 

C0M1_HAN 

DW 

? 

;allocate space to store handle 




;(valup to be assigned) 

;Ready to 

send 

the string ’HELLO’. Set up the required 

;register. The input buffer 

’s segment address is assumed to be 

;the same 

as the current DS. 



MOV 

AX,DS 

;assume data block segment address 


MOV 

DATA SEG,AX 

; be the same as the current DS 


MOV 

AX,l4503H 

;I/0 control write 


MOV 

BX,C0M1 HAN 

;move C0M1 handle into BX 


MOV 

CX ,8 

;8 bytes in input buffer 


MOV 

DX,OFFSET IN 1 

BUF ;input buffer offset 


INT 

21H 

;call MS-DOS to send the data 
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Read Data Block 


For block input, an application can use MS-DOS I/O control read function khE to 
get data into an application buffer. Once an application reads a block of data 
into a buffer, it can read single characters from the buffer. When the 
application buffer is empty, the application makes another "I/O control read" 
request to the system firmware. Since the system firmware maintains a 256 -byte 
buffer for each data comm port, it can be buffering up additional characters 
while the application is working on its own buffer characters. This technique 
improves an application’s data comm performance significantly. 

Data comm functions (8,1) through (8,7), described earlier, use I/O control 
sub-function 3 (UU03H) to perform a "write to control channel" operation. To 
read a block of data, you can use sub-function 2. I/O control sub-function 2 
(Uh02H) lets you read as many bytes as the system firmware has buffered without 
waiting for an exact number of characters. Since the system maintains a 
256 -byte buffer, an application should allocate a buffer of the same size or 
less for storing data. 


Unlike the I/O control sub-function 3, sub-function 2 does not use an input 
buffer stored with the function code and other parameters; it only requires a 
buffer to return the data block. 

Input Buffer : 

((BUFFER)) A pointer to a 2-word buffer for 

returning the data block 

First word = Buffer offset address 
Second word = Buffer segment address 

Outputs : 


Carry = 0 Successful 

Carry = 1 Unsuccessful 


Number of bytes returned in the specified 
buffer 


*** See an example of this function on next page 


*«* 
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Example : 

The following program segment reads a block of data into a buffer named 
DC BUF. 


;Allocate a buffer to read a data block. 

DC_BUF DB 256 DUP(?) ;allocate 256 bytes of 

; uninitialized buffer 

DC COUNT DW ? ;stores DC_BUF byte count 

C0M1 HAN DW ? ;stores device handle 


Assumed that the device is already opened and the device handle is 


stored in C0M1_HAN. 

MOV AX,UU02H 
MOV BX,C0M1_HAN 

MOV CX,256 

MOV DX,OFFSET DC_BUF 


I NT 21H 

MOV DC_COUNT,AX 
RET 


;I/0 control read 

;get handle from C0M1_HAN and 

; store in BX 

;read up to 256 bytes 

;pass buffer offset address, 

;assume segment address already 
; in DS 

;call MS-DOS to read data 
;save byte count in DC_COUNT 
;return 
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Programming Considerations 


MS-DOS has two processing modes: Cooked mode and Raw mode. If a device is in 
Cooked mode, MS-DOS checks each character passing through the device for special 
significance. If a device is in Raw mode, MS-DOS passes characters directly to 
the device; it does not try to interpret the characters. 

When you open data comm device C0M1 or COM2, it is normally in Cooked mode. In 
Cooked mode, MS-DOS checks for characters such as an end-of-file marker, printer 
echo, and other special characters, and processes them. 

By turning the data comm device into Raw mode, you can prevent MS-DOS from 
looking for any special characters. As a result, you can speed up the data comm 
performance. You can use MS-DOS function UU hex to set the data comm device in 
Raw mode; this function is presented in the MS-DOS Progrcurmer' s Refez*€nce 
Manual . 
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The following assembly program segment opens device C0M1 and enters RAW 
mode: 

C0M1_HAN DW ? 

C0M1 DEV DB ’COM1’,0 


Open device C0M1. 


MOV 

DX,OFFSET C0M1 DEV ;points to device name to open 

MOV 

AH,3DH 

;MS-DOS open file function code 

MOV 

CX,2 

;request read/write access 

INT 

21H 

;call MS-DOS to execute function 

JC 

ERROR 

;if error occurs, carry is set 

MOV 

C0M1_HAN,AX 

;handle return in AX; save it 

mode 

to disable MS-DOS 

processing. 

MOV 

BX,C0M1 HAN 

;put C0M1 handle in BX 

MOV 

AX,UU00H 

;I/0 control - get device status 

INT 

21H 

;call MS-DOS to get device status 

MOV 

DH,0 

;clear high byte of status word 



; returned in DX 

OR 

DL,20H 

;set Raw bit (bit 5) 

MOV 

BX,COM1 HAN 

;put C0M1 handle in BX 

MOV 

AX,UU01H 

;I/O control - set device status 

INT 

21H 

;call MS-DOS to turn on Raw mode 

RET 


;return 


;allocate space to hold C0M1 handle 
;allocate a buffer with the device 
; name stored in it. Zero 
; terminates the name. 
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AN EXAMPLE OF A DATA COMM PROGRAM 


The following BASIC program calls an assembly routine to copy 80 characters from 
Port 2 to Port 1. 

5 defint a-z 

10 dim o(80) 

11 for x=l to 80 

12 o(x)=x 

13 next x 

15 print "before open" 

20 call popen 

22 print "before write" 

25 call ptwr 

27 print "before read" 

30 call pord(o(0)) 

35 print "ready to print values" 

37 print "number of characters";o(0) 

U0 for x=l to 80 
50 print o(x); 

60 next x 
65 call pclose 
70 end 
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DATA 

SEGMENT WORD PUBLIC ’DATA’ 

BUF OUT 

DB 


’ABCDEFGH’,0,’I’,70 DUP (0) 

BUF INI 

DB 


13,10 

BUF IN 

DB 


80 DUP (?),10,13, 

PORT 1 

DB 


’COMl’,0,0,0,0 

PORT 2 

DB 


’COM2’,0,0,0,0 

HAND 1 

DW 


1 

HAND_2 

DW 


1 

KP PRT 

DW 

1 


CHG RAW DW 

? 


CHG TRN 

DB 

3,8 


CHG NRM 

DB 

U,8 


DATA 

ENDS 


DGROUP 

GROUP DATA 


CODE SEGMENT BYTE PUBLIC ’CODE’ 
ASSUME CS:CODE,DS:DGROUP 

PUBLIC POPEN,PTWR,PORD,PCLOSE 


POPElf PROC FAR 
PUSH BP 
MOV BP,SP 
PUSH DS 

MOV AX,3D02H 
LEA DX, PORT_l 
INT 21H 
MOV HAND_1,AX 

MOV AX,3D02H 
LEA DX,PORT_2 
INT 21H 
MOV HAND_2,AX 

MOV AX,U400H 
LEA DX,CHG_RAW 
XOR CX,CX 
MOV BX,HAND_1 
INT 21H 

MOV KP_PRT,DX 

OR DX,0020H 
XOR DH,DH 
MOV AX,UU01H 
INT 21H 

MOV AX,4403H 
LEA DX,CHG_TRN 
MOV CX,0002H 


;open Portl 


;open Port2 


;get COM1 characteristics 


;SET TO RAW MODE 


;set up transparency mode 


6-20 



Data Communications Programming 


MOV BX,HAND_1 
INT 21H 

POP DS 
POP BP 
RET 0 

POPEN ENDP 

PTWR PROC FAR 
PUSH BP 
MOV BP,SP 
PUSH DS 

MOV AX,4000H ;output data to Port2 

LEA DX,BUF_OUT 
MOV CX,80 
MOV BX,HAND_2 
I NT 21H 

POP DS 
POP BP 
RET 0 

PTWR ENDP 

PORD PROC FAR 

PUSH BP 
MOV BP,SP 
PUSH DS 

MOV AX,4402H ;input data from Portl 

MOV BX,HAND_1 
LEA DX,BUF_IN 
MOV CX,80 
INT 21H 

MOV CX,AX 
XOR SI,SI 
XOR AX,AX 
MOV BX,[BP+6] 

MOV [BX],CX 

TRNLP: MOV AL,BUF_IN[SI] 

MOV [BX]+2,AX 
ADD BX,2 
INC SI 
LOOP TRNLP 

POP DS 
POP BP 
RET 2 

PORD ENDP 

PCLOSE PROC FAR ; S et the ports back to normal and 

;close them 
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PUSH BP 

MOV BP,SP 

PUSH DS 



MOV AX,UU03H 

LEA DX,CHG NRM 

MOV CX,0002H 

MOV BX,HAND 1 

INT 21H 

;turn off transparency mode 


MOV DX,KP PRT 

XOR DH,DH 

MOV AX,UU01H 

XOR CX,CX 

MOV BX,HAND 1 

INT 21H 

;turn on Cook mode 


MOV AX,3E00H 

MOV BX,HAND 1 

INT 21H 

;close Port 1 


MOV AX,3E00H 

MOV BX,HAND 2 

INT 21H 

;close Port 2 


POP DS 

POP BP 

RET 0 

;return 

PCLOSE 

ENDP 


CODE 

ENDS 

END 



6-22 



AGIOS AND ESCAPE SEQUENCE 
QUICK REFERENCE 


APPENDIX 


This Appendix is intended to give you a quick reference to the AGIOS function 
calls and the equivalent escape sequences, where applicable. You need to refer 
to AGIOS sections to determine the parameters values which correspond to each of 
these function calls. 


AGIOS 


Equivalent 


Call 

Description 

Escape Sequence 

(0,0) 

Batch 


AIOS - 

Video Intrinsics 


(0,1) 

Define Area 


(0,2) 

Write Area 


(0,3) 

Clear Area 


(0,1*) 

Enhance Area 


(0,5) 

Read Area 


(0,6) 

Shift Area 


(0,7) 

Write Line 


AIOS - 

Application Softkeys 


(0,8) 

Update Softkey Label 


(0,9) 

Read Softkey Label 


(0,11) 

Display Softkey Labels 


(0,12) 

- (0,15) Reserved 


AIOS - 

Control Functions 


( 0 , 16 ) 

Execute Two-Character Sequence 

ESC character 

(0,17) 

Position Cursor 

ESC & a 

( 0 , 18 ) 

Define Enhancements 

ESC & d 

(0,19) 

Cursor Sense Absolute 

ESC a 

(0,20) 

Cursor Sense Relative 

ESC ' 

(0,21) 

Set Cursor Type 


(0,22) 

- (0,2U) Reserved 


(0,25) 

Read Fast AGIOS Entry Address 


( 0 , 26 ) 

Go to Terminal Mode 


(0,27) 

- (0,31) Reserved 



A-l 

















AGIOS and Escape Sequence Quick Reference 


AGIOS 

Call Description 


Equivalent 
Escape Sequence 


AIOS - Touchscreen Functions 


(0,32) 

Define Touch Field 

ESC 

(0,33) 

Define Softkey Field 

ESC 

(0,34) 

Delete Touch Field 

ESC 

(0,35) 

Touchscreen Reset 

ESC 

(0,36) 

Set Touch Sensing Modes 

ESC 

(0,37) - 

(0,39) Reserved 



AIOS - Keyboard Processing 

(0,40) Define Key Characteristics 

(0,41) Get Key Characteristics 

(0,42) Put Key 

(0,43) Turn Keycode Mode On/Off 

(0,44) Read Keycode Mode Status 

(0,45) Read Numeric/Graphics Keypad Status 

(0,46) Read Key 

(0,47) - (0,79) Reserved 
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AGIOS 

Call Description 


Equivalent 
Escape Sequence 


GIOS - Display Control (ESC * d) 


(4,1) 

Clear Graphics Memory 

ESC * d a 


(4,2) 

Set Graphics Memory 

ESC # d b 


(4,3) 

Turn On Graphics Display 

ESC * d c 


(4,4) 

Turn Off Graphics Display 

ESC * d d 


(4,5) 

Turn On Alphanumeric Display 

ESC * d e 


(4,6) 

Turn Off Alphanumeric Display 

ESC * d f 


(4,7) 

Turn On Graphics Cursor 

ESC * d k 


(4,8) 

Turn Off Graphics Cursor 

ESC * d 1 


(4,9) 

Turn On Rubber Band Line 

ESC * d m 


(4,10) 

Turn Off Rubber Band Line 

ESC * d n 


(4,11) 

Move Graphics Cursor Absolute 

ESC * d <x>,<y> o 


(4,12) 

Move Graphics Cursor Relative 

ESC * d <x>,<y> p 


(4,13) 

Turn On Alphanumeric Cursor 

ESC * d q 


(4,14) 

Turn Off Alphanumeric Cursor 

ESC # d r 


(4,15) 

Turn On Graphics Text Mode 

ESC * d s 


(4,16) 

Turn Off Graphics Text Mode 

ESC * d t 


GIOS - 

Vector Drawing Mode (ESC * m) 



(4,17) 

Select Drawing Mode 

ESC * m <mode> a 


(4,18) 

Select Line Type 

ESC * m <type> b 


(4,19) 

Define Line Pattern and Scale 

ESC * m <pattern> 

<scale> c 

(4,20) 

Define Area Fill Pattern 

ESC # m <pattern> 

d 

(4,21) 

Fill Rectangular Area, Absolute 

ESC * m <xl>,<yl> 

<x2>,<y2> e 

(4,22) 

Fill Rectangular Area, Relocatable 

ESC * m <xl>,<yl> 

<x2>,<y2> f 

(4,23) 

Select Polygonal Fill Pattern 

ESC * m <pattern> 

g 

(4,24) 

Select Boundary Pen 

ESC # m <pen> h 


(4,25) 

No Polygon Boundary 

ESC * m h 


(4,26) 

Set Relocatable Origin 

ESC * m <x,y> j 


(4,27) 

Set Relocatable Origin to Pen Position 

ESC * m k 
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AGIOS Equivalent 

Call Description Escape Sequence 


(4,28) 

Set Relocatable Origin to Cursor Position 

(4,29) 

Set Graphics Text Size 

ESC 

(4,30) 

Set Graphics Text Orientation 

ESC 

(4,31) 

Turn On Text Slant 

ESC 

(4,32) 

Turn Off Text Slant 

ESC 

(4,33) 

Set Graphics Text Origin 

ESC 

(4,34) 

Graphics Text Label 

ESC 

(4,35) 

Define User Character Set 


(4,36) 

Select Default Character Set 


(4,37) 

Output Single Text Character 


(4,38) 

Set Graphics Default 

ESC 

(4,72) 

Set Picture Definition Defaults 

ESC 

(4,73) 

Graphics Hard Reset 

ESC 

GIOS - 

Graphics Plotting 


(4,39) 

Lift Pen 

ESC 


Vector Move: 

ESC 

(4,40) 

absolute 


(4,41) 

incremental 


(4,42) 

relocatable 


(4,43) 

Lower Pen 

ESC 


Vector Draw: 

ESC 

(4,44) 

absolute 


(4,45) 

incremental 


(4,46) 

relocatable 


(4,47) 

Set Pen Position to Cursor Position 

ESC 

(4,48) 

Point Plot 

ESC 

(4,49) 

Set Relocatable Origin to Pen Position ESC 

(4,50) 

Start Polygonal Area Fill 

ESC 

(4,5D 

Terminate Polygonal Area Fill 

Polygon Move: 

ESC 

(4,52) 

absolute 


(4,53) 

incremental 


(4,54) 

relocatable 

Polygon Draw: 


(4,55) 

absolute 


(4,56) 

incremental 


(4,57) 

relocatable 


(4,58) 

Lift Boundary Pen 

ESC 

(4,59) 

Lower Boundary Pen 

ESC 


ESC * m 1 

* m <size> m 

* m <orientation> n 

* m o 

* m p 

* m <origin> q 

* 1 <text> 


* m r 

* m 1 r 

* w r 


* p a 

# p a <x>,<y> 


* P b 

* p b <x>,<y> 


* p c 

* P d 

* p e 

* p s 

* P t 


* p u 

* p V 
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AGIOS 

Call 


Description 


AGIOS and Escape Sequence Quick Reference 


Equivalent 
Escape Sequence 


GIOS - 

Graphics Status 




(Mo) 

Not Implemented 




(Mi) 

Read Pen Position 

ESC 

• 

s 2 a 

(4,62) 

Read Cursor Position 

ESC 

• 

s 3 a 

(4,63) 

Not Implemented 




(4,64) 

Read Display Size 

ESC 

• 

8 5 A 

(4,65) 

Read Graphics Settings 

ESC 

• 

s 6 A 

(4,66) 

Read Graphics Text Status 

ESC 

• 

s 7 A 

(4,67) 

Read Zoom Status 

ESC 

• 

s 8 A 

(4,68) 

Read Relocatable Origin 

ESC 

• 

s 9 a 

(4,69) 

Read Reset Status 

ESC 

• 

s 10 

(4,70) 

Read Area Shading 

ESC 

• 

s 11' 

(4,71) 

Read Dynamic Graphics Capabilities 

ESC 

• 

s 12' 

(4,74) 

Read Extended Screen Dimensions 
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AGIOS FUNCTION CALLS FROM 
HIGH-LEVEL LANGUAGES 


APPENDIX 


B 



The purpose of this appendix is to give you examples on how to use AGIOS 
function calls in high-level languages. Although the language example used here 
is in MS-Pascal, the same principles apply to other high-level languages. The 
example calls an assembly routine to home the cursor. Even though the operation 
is a simple one, you can apply the concepts to call other AGIOS functions. A 
more complex MS-BASIC program calling AGIOS touch functions is also included at 
the end of this appendix. 


NOTE 


If you are using a different high-level language, you should 
understand the concepts discussed in this section. Then you 
should read the section in the language manual that discusses 
calling an assembly routine and passing parameters to it for 
the actual details of implementation. 















AGIOS Function Calls from High-Level Languages 


GETTING STARTED WITH PASCAL 

To use AGIOS function calls, you need a working knowledge of the following 
areas: 

o HP 150 capabilities (touchscreen, graphics, etc.) 
o AGIOS function calls 
o Intel 8086/8088 assembly language 
o MS-DOS system calls 
o MS-Pascal 

You need these reference materials handy: 

o The MS-Pascal language manual 
o The MS-Pascal compiler manual 
o The MS-DOS Programmer’s Reference Manual 
o An 8086/8088 assembly language reference manual 

You should have the following software: 

o The MS-Pascal compiler and linker 
o The MS-8088 macro assembler 

o A text editor or word processor to create source code files 
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PASSING AGIOS PARAMETERS FROM PASCAL 

You can call assembly routines to execute AGIOS functions from a Pascal program. 
In order for the AGIOS functions to execute successfully, the Pascal program has 
to pass the required parameters to the assembly routines. 

To pass the input parameters to your assembly language routine, you need to 
create a buffer. This buffer contains all the required input information that 
should be passed by reference . In addition, you need to tell the assembly 
routine the length of the buffer. The buffer length field is an integer field 
that is passed by value . 


The first thing you need to do is to create a buffer that contains the AGIOS 
function code and other information that may be required for the function call. 
The following example homes the cursor by using the AGIOS function (0,l6), 
"Execute Two-Character Sequence". The buffer is set up as a PACKED ARRAY OF 
CHAR, with the value 16 in byte 0, the value 0 in byte 1, and the character H in 
byte 2. This is because the Intel 8088 processor addresses information in a 
word in reverse order (low byte first, then high byte). The data is passed as 
follows: 


Contents--> | 16 | 0 | H | 


Byte --> 0 +1 +2 

Since the data buffer has three bytes, we need to pass a length of 3 to the 
assembly language program. 

Here is an example of a simple Pascal program that homes the cursor: 

program try_agios (input,output); 

{This program demonstrates the passing of input 
parameters to an assembly language routine. The program 
homes the cursor.) 

(define an agios data buffer type) 

type buffer = record 

low_byte : byte; 
high_byte : byte; 
char_code : char 

end; 

{declare assembly language routine as external; pass the 
data by reference and the length by value. Pick up the 
AGIOS error status as an integer result of the function 
(0 = no error).) 
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function agios( var parms : buffer; 

length : integer) : integer; extern; 

{declare variables) 

var homeup : buffer; 
ret : integer; 


begin 

(load the agios input values into the buffer) 

homeup.low_byte := l6; 
homeup.high_byte := 0; 
homeup.char_code := ’H’; 

{execute agios homeup function and get error status) 
ret := agios(homeup,3); 

{write return status; zero is no error) 
writeln('return status: ’,error); 
end. 


NOTE 


MS-Pascal has the pre-defined type BYTE. See the MS-Pascal 
language reference manual for more information. 


It may seem like a lot of work to just home the cursor, but the AGIOS method 
provides faster I/O. There are advantages to using more powerful AGIOS 
functions that write large blocks of text to the screen and handle graphics 
output. 
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GETTING AGIOS PARAMETERS FROM THE STACK 

When the Pascal program passes control to the assembly routine, the parameters 
are pushed on the stack first. The Pascal program then pushes the return 
address on the stack. The stack grows downward and the stack pointer (SP) 
always points to the last element pushed onto the stack. The assembly routine 
must know how to get the input parameter from the stack. 

You should read the section in the MS-Pascal compiler manual that discusses 
passing parameters. Here are a few key points to remember: 

o Pascal only does FAR calls. Each call puts a return segment address and a 
return offset address on the stack. 

o Pascal pushes the parameters on the stack irom left to right . That is, the 
leftmost parameter in the argument list is pushed on the stack first and 
the rightmost parameter is pushed last. 

o Pascal expects the assembly routine to clean up the passing parameters on 
the stack. You can clean up space allocated on the stack for the 
parameters by using the assembler instruction RET <n>. <n> is 2 times the 

number of parameters passed. 

To demonstrate the use of the stack in passing parameters, let us assume the 
following Pascal call statement: 


AGIOS (parameterl, parameter2) 

Since Pascal pushes the parameters on the stack from left to right, the 
following table illustrates the state of the stack at the time the CALL 
statement is executed: 


High Memory 

I 

I 

Stack Pointer 

I 

I 

v 

Low Memory 


+-+ 

| Parmeterl 


Parameter2 


Return Segment 
Return Offset 


SP + 6 
SP + U 
SP + 2 

<-- Current Stack Pointer 


(SP) 


B-5 











AGIOS Function Calls from High-Level Languages 


In order to fetch the parameters from the stack, it is recommended that you use 
the BP (Base Pointer) register as the index pointer. Before assigning BP as the 
index pointer, you should preserve the current BP value. You can save BP by 
pushing it on the stack. After BP is saved, you can then assign BP to the 
current SP. You should also save DS because it contains the parameters data 
segment address. You can save DS by pushing it on the stack. The following 
assembly instructions implement the above procedure: 


PUSH BP 
MOV BP,DS 
PUSH DS 

As a result, the state of the stack looks as follows (with BP equates to SP) 


High Memory 

I 

Stack Pointer 


Parameterl 


Parameter2 


Return Segment 


Return Offset 


BP 


DS 


Low Memory +- 


BP + 8 
BP + 6 
BP + U 
BP + 2 
BP + 0 

<-- Current Stack Pointer (SP) 


The assembly program on the next page shows how to fetch the parameters from the 
stack using BP as the base index pointer. 
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ASSEMBLY LANGUAGE INTERFACE TO PASCAL 

The next thing the assembly routine has to do is to load certain registers with 
the information passed to it on the stack. The assembly routine can use the MOV 
instruction to transfer information pointed by BP plus a positive offset to the 
assembly registers. For example, to move Parameter from the previous example 
into the CX register, you can use the following assembly instruction: 

MOV CX,[BP+6] 

The following registers are used when you issue an AGIOS call: 

Register Function 


AH 


AL 


BX 

CX 

DS 


DX 


Contains the MS-DOS system function number that does device I/O 
control. This is function number UUH and is described in the 
MS-DOS Programmer's Reference Manual . 

Specifies the I/O control options in function UUH. For AGIOS 
calls, this option number is 3 and it indicates a "write" to the 
device control channel. 

Contains the device handle number. All AGIOS functions use 1 as 
the device handle. 

Specifies the number of bytes being passed in the input buffer. 

In the earlier "home cursor" example, this was 3. 

Contains the input buffer’s segment address. This address is 
passed to the .routine in the DS register; therefore, the assembly 
routine should not alter the DS register upon entry from a Pascal 
program. 

Contains the input buffer’s offset address. This is part of the 
address when we pass data by reference 


The last step in the assembly language routine is to issue an INT 21H 
intruction. This instruction generates a software interrupt that passes program 
control to MS-DOS to perform the AGIOS function. 

Upon return from the interrupt, the AX register is loaded with a completion 
status. A zero value indicates no error while non-zero values indicate errors. 
The Pascal example in the next section entitled "Passing Pointers to AGIOS from 
Pascal" shows the AX being returned. 
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Here is the assembly routine named AGIOS that homes the cursor: 


PGROUP 

GROUP 

PROG 

PROG 

SEGMENT 

BYTE PUBLIC ’PROG’ 


ASSUME 

CS:PGROUP 


PUBLIC 

AGIOS 

; calling convention: AGIOS(buf,count) 

; A picture of the 

stack after the Pascal call. 

; high memory 



|low byte 

| high byte| Buffer address 


+- 



|low byte 

| high byte| Buffer length 


+- 



|low byte 

| high byte| Return segment address 


+- 


; SP- ; 

> |low byte 

| high byte| Return offset address 


+- 


; low 

memory 




stack grows down 

AGIOS 

PROC 

FAR 

PUSH 

BP 

;Save callers registers 

MOV 

BP,SP 

;Assign BP as the index pointer 

PUSH 

DS 
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After BP is pushed to the stack, the SP pointer moves down 
2 bytes. Therefore, the first parameter, buffer length, 
is stored at the location pointed by (SP+6). 


MOV 

DX,[BP+8] ;Get buffer address 

MOV 

CX,[bp+6] 

;Get buffer length 

MOV 

BX,1 

;Console output handle 

MOV 

AX,4403H 

Call the I/O control function 

INT 

21H 

44H and use option 3 to write 
to device control channel 

POP 

DS 

;Restore registers 

POP 

BP 


RET 

4 

Toss 4 bytes, previously 

occupied by agios parameters 
on the stack. 

AGIOS 

ENDP 


PROG 

ENDS 

END 
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PASSING POINTERS TO AGIOS FROM PASCAL 

Some AGIOS functions require blocks of data that are not in the input buffer to 
be passed to or from your program. For example, the Write Area function needs a 
double-word pointer to the buffer which contains the text that you wish to write 
to the screen. The Cursor Sense Absolute function requires a double-word 
pointer to a buffer that AGIOS uses to return the current X,Y coordinates. 

The double-word pointer has the following structure: 

Word 1 = Offset address of the data buffer 
Word 2 = Segment address of the data buffer 

The best way to get this information is to use a special data type available in 
MS-Pascal, ADS. ADS provides the information you need to get the buffer 
address. 

The following example uses the AGIOS function that returns the absolute position 
of the alpha cursor. The AGIOS input string for this function is the address of 
the buffer to be used for returning the cursor position. 


program cursor_sense_absolute (input,output); 


integer; 


retum_buf 

end; 

var ret : integer; 

agios_inputs : input_buf; 
cursor_pos : retum_buf; 


type retum_buf = array [1.. 2] of 
input_buf = record 
func_low_byte : byte; 
func_hi_byte : byte; 
address : address of 
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function agios ( var parms : input_buf; 

length : integer) : integer; extern; 


begin 

{load function code 0 , 19 ) 
agios_inputs.func_low_byte := 19 ; 
agios_inputs.func_hi_byte := 0; 

{load address of output buffer} 
agios_inputs.address := ads cursor_pos; 

{call agios function) 

ret := agios(agios_inputs,6); 

{cursor position is now in the integer array CURS0R_P0S} 

writeln(’return status =’,ret); 
writeln(’row = ’,cursor_pos[1]); 
wr iteln (’col =’ ,cursor_j>os [2]); 
end. 


Refer to the MS-Pascal language reference manual for more information on 
the ADS type and function. 


using 
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CALLING AGIOS FROM BASIC 

The example in this section shows how to call an AGIOS routine from BASIC. You 
should read the BASIC compiler manual for details on calling and passing 
parameters to an assembly routine. 


NOTE 


Calling an assembly routine from the interpretive BASIC 
is difficult and cumbersome. Therefore, the compiled 
BASIC is recommended. 


The following are a few key points to remember when calling AGIOS routines from 
Compiled BASIC: 

o Although the USR function allows access to assembly routines, the CALL 
statement is recommended for interfacing the Intel 8088 family of assembly 
language programs with BASIC. 

o BASIC pushes parameters onto the stack from left to right . 

o The assembly routine must know the number of parameters passed. References 
to parameters are positive offsets added to the BP register (assuming the 
called routine moved the current stack pointer into the BP register). 

o BASIC passes parameters by reference only ; that is, the address of the 
parameter is passed, not the actual value. 

o The assembly routine must know the variable type for the passed parameter. 
If possible, pass integer variables to the assembly routine instead of 
short or long real numbers. Integer variable is stored in two bytes. The 
address of the low byte (lower order 8 bits) is passed on the stack. 

o If the parameter is a string, the address of the paramenter points to a 
U-byte string descriptor . Byte 0 and 1 of the string descriptor contains 
the length of the string. Bytes 2 and 3, respectively, are the offset and 
segment addresses of the string starting address. 

o If the argument is a string literal in the program, the string descriptor 
will point to program text. To avoid altering your program, add a null 
string to the string literal in your program. For example, the statement: 

10 A$ = "BASIC" + ”” 

will force the string literal to be copied into BASIC string space, not 
program space. Now the string may be modified without affecting the 
program. 

o Strings may be altered by assembly routines, but the length must not be 
changed. BASIC cannot correctly manipulate strings if their lengths are 
modified by externals routines. 


B-12 
















AGIOS Function Calls from High-Level Languages 


o The assembly routine must do a RET <n> statement, where <n> is 2 times the 
number of parameters in the argument list. This statement adjusts the 
stack to the start of the calling sequence. 

o Value is returned to BASIC by including the variable name that will receive 
the result in the argument list. 
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A BASIC PROGRAM CALLING AGIOS FUNCTIONS 


100 

no 

120 

130 

i4o 

150 

160 

170 

180 

190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

4oo 


REM This Basic program demonstrates how an AGIOS function can be 
REM called from Compiled BASIC. 

REM 

REM This program calls AGIOS to define some touch fields. 

REM The steps are listed below: 

REM 1) Initialize escape sequences and set up definitions. 

REM 2) Clear the screen, turn off the touch fields and set the 
REM reporting mode. 

REM 3) Define 5 touch fields - these fields will return a single 
REM Roman-8 character to a Basic INPUT$ statement 
REM 4) Read that character and print it on the screen 
REM 

WIDTH 255 

CLS$=CHR$(27) + "H"+CHR$(27)+ m J" ’Escape sequence to clear screen 

’Function to move cursor 


DEF FNL0CATE$(R0W,C0L)=CHR$(27)+"&a"+STR$(ROW)+"r"+STR$(COL)+"C" 
PRINT CLS$ ’Clear the screen 

CALL OFFTOUCH ’Initialize touchscreen 


R0W%=5 
COL%=6 
R0WINC%=2 
COLINC%=10 
FOR I = 1 TO 5 


’Set up parameters for 
’ calls to FNTOUCH - 
’Set up row increment 
’Set up column increment 
’Define 5 fields 


ROW%=I*4-3 ’Calculate row number 

RESPONSE$=CHR$(I+48) ’Calculate response string 

CALL FNTOUCH(R0W%,C0L%,R0WINC%,COLINC%,RESPONSE$) ’Define the field 
PRINT FNL0CATE$(R0W%+1,7);"Choice M ;RESPONSE$ ’Print field label 
NEXT I ’Loop 

A$=INPUT$(1) ’Read touch response 

PRINT FNLOCATE$(20,1)Choice ";A$;" was selected" ’Echo the response 
END 
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FNTOUCH(START_ROW, START_COLUMN, NUM_ROWS, NUM_COLUMNS, RESPONSE) 

Define a touch field at (START_ROW, START_COLUMN). The lower 
right comer of the field is calculated by adding NUM_ROWS 
to START_ROW and NUM_COLUMNS to START_COLUMN. The response 
string is pointed to by RESPONSE (the first word is the 
length of the string and the second word is the address of 
the string. 

There is no functional return. 


CODE SEGMENT PARA PUBLIC ’CODE* 

ASSUME CS:CODE,DS:CODE,ES:NOTHING,SS:NOTHING 
PUBLIC FNTOUCH 


START ROW 

EQU 

lU 

START COLUMN 

EQU 

12 

NUM ROWS 

EQU 

10 

NUM COLUMNS 

EQU 

8 

RESPONSE 

EQU 

6 

STACK_SIZE 

EQU 

5*; 

page 

FNTOUCH PROC 

FAR 



;Offset to parmeters on 
; the stack 


;5 parmeters of 2 bytes each 


PUSH BP 

MOV BP,SP 

PUSH DS 

MOV SI,START_ROW[BP] 

MOV AH,[SI] 

MOV SI,START_COLUMN[BP] 

MOV AL,[SI] 


;Save incoming BP register 
;Point to parameters 
;Save incoming data segment 

;Get address of start row 
;Put row number in high byte 

;Point to column number 
;Put column in low byte 


MOV CS:WORD PTR UPPER_CORNER,AX ;Save upper left comer 

MOV SI,NUM_ROWS[BP] ;Point to number of rows 

ADD AH,[SI] ;Add to start row to get last row 


MOV SI,NUM_COLUMNS[BP] ;Point to number of columns 

ADD AL,[SI] ;Calculate last column number 


MOV CS:WORD PTR LOWER_CORNER,AX ;Save lower right comer 


MOV 

CLD 

LODSW 

MOV 


SI,RESPONSE[BP] ;Point to response string 

;Increment index on string operation 
;Get length of the string 

CSrWORD PTR RES_LEN,AX ;Put length in input buffer and 
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LODSW 




;Get string starting address 

MOV 

CS:WORD 

PTR [RES STRING],AX ;Put string offset 





; in input buffer 

MOV 

AX,DS 



;Put string segment in input buffer 

MOV 

CS:WORD 

PTR [RES_STRING+2],AX 

MOV 

AX,UU03H 


;IOCTL write (MSDOS AIOS call) 

MOV 

BX,1 



;console output handle 

MOV 

CX,OFFSET LEN AIOS CAL ;Length of input buffer 

MOV 

DX,OFFSET AIOS 

_CALL 

;Get offset of input buffer 

PUSH 

CS 



;Get segment of input buffer 

POP 

DS 



; into DS 

I NT 

21H 



;Go define the touch field 

POP 

DS 



;Restore incoming DS 

POP 

BP 



;Restore incoming BP 

RET 

STACKJSIZE 


;Clean up stack and return 

page 





AIOS CALL: 





DW 

32 



;Define touch field function code 

RES STRING 

LABEL 

WORD 



DW 

2 

DUP(?) 


;Allocate two words for address 





; of response string 

RES LEN 

LABEL 

WORD 



DW 

? 



;Length of response string 

DB 

2 



;Report on release 

DB 

1 



;ASCII touch attribute 

DB 

’J* 


;Of f 

enhancement - half bright inverse 

DB 

’B’ 


;On 

enhancement - Full bright inverse 

DB 

0 



;Do not beep 

DB 

0 



;Do not position cursor 

UPPER CORNER 

LABEL 

WORD 



DW 

? 



;Upper left coordinates 

LOWER CORNER 

LABEL 

WORD 



DW 




;Lower right coordinates 


LEN_AIOS_CALL EQU 

$-AIOS_CALL 

;Length of input buffer 

FNTOUCH ENDP 
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OFFTOUCH 

Deletes all previously defined touch fields and sets the reporting 
mode to that specified by the called program. 


; There is no 

5 

functional return. 


* 

PUBLIC 

OFFTOUCH 


OFFTOUCH 

PROC FAR 


PUSH 

DS 

;Save the incoming DS register 

PUSH 

CS 

;Set DS to current code segment 

POP 

DS 

MOV 

AX,UU03H 

;I/0 control write 

MOV 

BX,1 

;Console device handle 

MOV 

CX,OFFSET LEN TURN IT 

OFF ;Length of the buffer 

MOV 

DX,OFFSET TURN IT OFF" 

;Address of the buffer 

INT 

21H 

;Go delete fields 

MOV 

AX,UU03H 

;I/0 control write 

MOV 

BX,1 

;Console device handle 

MOV 

CX,OFFSET LEN REPORT MODE ;Length of buffer 

MOV 

DX,OFFSET REPORT MODE 

;Select field-reporting mode 

INT 

21H 

POP 

DS 

;Restore incoming DS 

RET 



TURN IT OFF: 



DW 

3U 

;Tum off touch function code 

DW 

OFFFFH 

;Delete all touch fields 

LEN_TURN_IT_OFF 

EQU $-TURN_IT_OFF 

;Length of the command 

REPORT MODE: 



DW 

36 

;Select report mode 

DW 

12 

;Report fields 

DW 

2 

;Report on releases only 

LEN_REPORT_MODE EQU $-REPORT MODE 


OFFTOUCH 

ENDP 



CODE 


ENDS 

END 
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AGIOS FUNCTION CALL EXAMPLES 


app'enoix 



c 


As mentioned in earlier sections, you can access AGIOS functions from high-level 
languages, such as BASIC or Pascal. 

This appendix has examples on AGIOS video functions that are callable from 
Pascal. These video functions are Define Area, Write Area, Clear Area, Enhance 
Area, Read Area, Shift Area, and Write Line. 

There is a comment block at the beginning of each example. The comment block 
describes each parameter in the parameter lists. 

These examples get the input parameters from the stack and store them in an 
input buffer labeled AIOS_CMD. Once AIOS_CMD and other input registers are set 
up, AGIOS is called to execute the desired function. These example also assume 
that data resides in the default data segment pointed by the DS register. 

Appendix B has detailed information on calling AGIOS functions from high-level 
languages. 








J 


C-l 


















AGIOS Function Call Examples 


DEFINE AREA 


FUNCTION DEF_AREA( UPPER_ROW: 

LOWER_ROW: 
LEFT_COLUMN: 
RIGHT COLUMN: 


INTEGER; 

INTEGER; 

INTEGER; 

INTEGER):INTEGER; 


This function defines an area for the other video intrinsics. 


UPPER_ROW - 
LOWER_ROW - 
LEFT_COLUMN - 
RIGHT COLUMN - 


The upper row number of the area (top edge is 0) 

The bottom row number of the area (bottom edge is 47) 
The leftmost column of the area (left edge is 0) 

The rightmost column of the area (bottom edge is 47) 


DEF AREA - 


Returns 0 if the call was successful 


AIOS ENTRY 

EQU 

4403H 

;I/0 Control Write 

AIOS HANDLE 

EQU 

1 

;Console handle 

MSDOS 

EQU 

21H 

;MSDOS entry point 


AIOS DATA 

GROUP 

AIOS DATA 


AIOS_CODE 

GROUP 

AIOS_CODE 


AI0S_DATA 

SEGMENT 

BYTE PUBLIC 

> AI0S_DATA’ 


ASSUME 

DS:AI0S_DATA 


AIOS CMD 

DW 

1 

;Define Area function code 

LR COL 

DB 

? 

;Lower right column 

LR ROW 

DB 

? 

;Lower right row 

UL COL 

DB 

? 

;Upper left column 

UL ROW 

DB 

? 

;Upper left row 

PREV COORD 

DW 

-1,-1 

;Don’t return previous 

" 



coordinates 

AI0S_LEN 

EQU 

$-AI0S_CMD 

;Length of the input buffer 

AIOS DATA 

ENDS 
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AIOS_CODE SEGMENT BYTE PUBLIC ’AIOS CODE’ 



ASSUME CS:AIOS CODE 

UPPER ROW 

EQU 12 

LOWER ROW 

EQU 10 

LEFT_COLUMN 

EQU 8 

RIGHT COLUMN 

EQU 6 

POP_PARMS 

EQU 8 


PUBLIC DEF AREA 

DEF_AREA 

PROC FAR 

PUSH 

BP 

MOV 

BP,SP 

PUSH 

DS 

MOV 

AX,AIOS DATA 

MOV 

DS,AX 

MOV 

ES, AX 

CLD 


MOV 

DI,OFFSET LR_COL 

MOV 

AL,RIGHT_COLUMN[BP] 

STOSB 


MOV 

AL,LOWER_ROW[BP] 

STOSB 


MOV 

AL,LEFT_COLUMN[BP] 

STOSB 


MOV 

AL,UPPER_ROW[BP] 

STOSB 


MOV 

AX,AIOS ENTRY 

MOV 

BX,AIOS HANDLE 

MOV 

CX,AIOS LEN 

MOV 

DX,OFFSET AIOS CMD 

INT 

MSDOS 

POP 

DS 

POP 

BP 

RET 

[POP_PARMS] 

DEF AREA 

ENDP 

AIOS_CODE 

ENDS 


END 


J:AIOS_DATA, ES:AIOS_DATA 

;Stack offset for fetching 
; parameters from the 
; stack 

;Total parameter size (in bytes) 
;DEF_AREA entry point 


;Save incoming BP 

;Set up BP to read parameter 

;Save incoming DS 

;Set ES & DS to specified data segment 


;Set flag to increment DI on string op 
;Point to AIOS buffer data structure 

;Get the right column number from stack 
;Move right column in AIOS buffer 

;Move lower row number in AIOS buffer 

;Move left column into AIOS buffer 

;Move upper row number in AIOS buffer 

;Set up registers to call AIOS 


;Go define the area - recall that 
; AX=0 implies call was succesful 
;Restore incoming registers 

;Toss parameters and return 
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WRITE AREA 


. .************************************************ 


FUNCTION 


WRITE AREA( 

ARRAY LEN: 

INTEGER; 

VAR 

CHARACTERS: 

CHAR; 

VAR 

CHAR SETS: 

CHAR; 

VAR 

ENHANCEMENTS: 

CHAR):INTEGER 


This function writes characters, enhancements, and or 
character sets to the previously defined area. 


ARRAY_LEN - 
CHARACTERS - 

ENHANCEMENTS - 
CHAR SETS - 


The length of the array(s) 

Offset pointing to the first character in a 

stream of characters to be written to the area 
Offset of the first enhancement code 
Offset of the first chararter set code 


WRITE AREA - Returns 0 if the call was successful 


If the first character is OFFH, then this routine assumes that 
there aren’t any data associated with that parameter. The 
segment will be set to -1 for AIOS to ignore that parameter. 



AIOS ENTRY 

EQU 

U403H 

AIOS HANDLE 

EQU 

1 

MSDOS 

EQU 

21H 

AIOS DATA 

GROUP 

AIOS DATA 

AIOS_CODE 

GROUP 

AIOS_CODE 

AIOS_DATA 

SEGMENT 

BYTE PUBLIC 


ASSUME 

DS:AIOS_DATA 

AIOS CMD 

DW 

2 

DATA LENGTH 

DW 

? 

ENH PTR 

DD 

? 

CHAR SET PTR 

DD 

? 

ASCII PTR 

DD 

? 


I/O control write 
Console device handle 
MSDOS entry point 


AIOS DATA’ 


;Write Area function code 
;Length of the data arrays 
;Points to enhancement codes 
;Points character set codes 
;Points to character codes 
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AIOS LEN 

EQU 

$-AIOS_CMD 

AIOS_DATA 

ENDS 


AIOS_CODE 

SEGMENT 

BYTE PUBLIC 


ASSUME 

CS:AIOS_CODE 

ARRAY LEN 

EQU 

12 

CHARACTERS 

EQU 

10 

CHAR SETS 

EQU 

8 

ENHANCEMENTS 

EQU 

6 

POP_PARMS 

EQU 

8 


PUBLIC 

WRITE AREA 

WRITE_AREA 

PROC 

FAR 

PUSH 

BP 


MOV 

BP,SP 


PUSH 

DS 


MOV 

BX,AIOS 

DATA 

MOV 

ES,BX 


CLD 



MOV 

DI,OFFSET ENH_PTR 

MOV 

SI,ENHANCEMENTS[BP] 

CALL 

LOAD PARM 

MOV 

SI,CHAR SETS[BP] 

CALL 

LOAD PARM 

MOV 

SI,CHARACTERS[BP] 

CALL 

LOAD PARM 

ASSUME 

DS:AIOS 

DATA 

MOV 

DS,BX 



;Length of the AIOS buffer 
’AIOS_CODE’ 

DS:NOTHING, ES:AIOS_DATA 

;Locate the input parameters 
; passed on the stack 

;Total parameter size (in bytes) 

;WRITE_AREA entry point 

;Save Incoming BP 

;Set up BP to read parameters 

;Save incoming DS 

;Set ES to specified data segment 

;Set flag to increment on string op 
;Point to AIOS buffer structure 

;Set up enhancement pointer 

;Set up character sets pointer 

;Set up characters pointer 

;Set DS to defined data segment 


MOV AX,ARRAY_LEN[BP] ;Move length into AIOS buffer 

MOV DATA_LENGTH,AX 


MOV AX,AIOS_ENTRY 

MOV BX,AIOS_HANDLE 

MOV CX,AIOS_LEN 

MOV DX,OFFSET AIOS_CMD 

INT MSDOS 


POP 

POP 

RET 

WRITE AREA 


DS 

BP 

[POP_PARMS] 
ENDP 


;Set up parameters for AIOS 


;Write area and recall that AX=0 
; implies the call was successful 
;Restore incoming registers 

;Toss parameters and return 
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The following routine moves the pointer from (DS:SI) to (ES:DI) 


LOAD_PARM 

CMP 

JZ 

MOV 

MOV 

ADD 

RET 


PROC NEAR 

BYTE PTR [SI],0FFH 
NULL_PTR 
ES:[DI],SI 
ES:[DI+2],DS 
DI ,U 


Is first byte = OFFH? 

YES - put null into AIOS buffer 
NO - put the pointer (DS:SI) 
into (ES:DI) 

Adjust ES:DI for next pointer 


NULL_PTR: 

MOV AX,OFFFFH 

STOSW 

STOSW 

RET 

LOAD PARM ENDP 


OFFFFH indicates a null pointer 
Put a null pointer into 
AIOS buffer and add advance 
index 


AIOS CODE ENDS 


END 
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AGIOS Function Call 


Examples 


CLEAR AREA 


FUNCTION CLEAR_AREA : INTEGER; 

This function clears the entire defined area (characters sets 
to blanks, enhancements to ’none’, and characters to ’Roman’). 


; CLEAR_ 

* 

AREA - 

Returns 0 if 

the call was successful 

AIOS ENTRY 

EQU 

U403H 

;I/0 control write 

AIOS HANDLE 

EQU 

1 

;Console device handle 

MSDOS 

EQU 

21H 

;MSDOS entry point 

AIOS DATA 

GROUP 

AIOS DATA 


AIOS_CODE 

GROUP 

AIOS_CODE 


AIOS_DATA 

SEGMENT 

BYTE PUBLIC 1 

‘AIOSJDATA’ 


ASSUME 

DS:AIOS_DATA 


AIOS_CMD 

DW 

3 

;Clear Area functin code 

AIOS_LEN 

EQU 

$-AIOS_CMD 

;Length of the AIOS buffer 

AIOS_DATA 

ENDS 



AIOS_CODE 

SEGMENT 

BYTE PUBLIC ’ 

AIOS CODE’ 


ASSUME 

CS:AIOS_CODE, 

DS:AIOS_DATA 

POP_PARMS 

EQU 

0 

;Total parameter size (in bytes) 
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PUBLIC 

CLEAR AREA 

CLEAR_AREA 

PROC 

FAR 


;CLEAR_AREA entry point 


PUSH DS 


;Save incoming DS 


MOV AX,AIOS_DATA ;Set DS to specified data area 

MOV DS,AX 


MOV AX,AIOS_ENTRY 

MOV BX,AIOS_HANDLE 

MOV CX,AIOS_LEN 

MOV DX,OFFSET AIOS_CMD 

INT MSDOS 


;Set up parameters for the 
; call 


;Go clear the area 
;AX = 0 implies no error 


POP DS 
RET 


;Restore incoming registers 
;Toss parameters and return 


CLEAR_AREA ENDP 

AIOS_CODE ENDS 

END 
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ENHANCE AREA 


FUNCTION ENH_AREA( ENHANCEMENT: CHAR):INTEGER; 


This function ehnances the entire defined area with 
the selected ENHANCEMENT 


ENHANCEMENT - The desired enhancement type (a letter from 
.. ’ ’ 


; ENH_ 

5 

AREA - 

Returns 0 if 

the call was successful 

AIOS ENTRY 

EQU 

UU03H 

;I/0 control write 

AIOS HANDLE 

EQU 

1 

;Console device handle 

MSDOS 

EQU 

21H 

;MSDOS entry point 

AIOS DATA 

GROUP 

AIOS DATA 


AIOS_CODE 

GROUP 

AIOS_CODE 


AIOS_DATA 

SEGMENT 

BYTE PUBLIC 1 

*AIOS_DATA’ 


ASSUME 

DS: AIOS_DATA 


AIOS CMD 

DW 

U 

;Enhance Area function code 

ENHANCE 

DW 

? 

;Allocate a word for enhancement 

AIOS_LEN 

EQU 

$-AIOS_CMD 

;Length of the AIOS buffer 

AIOS_DATA 

ENDS 



AIOS_CODE 

SEGMENT 

BYTE PUBLIC 1 

'AIOS CODE’ 


ASSUME 

CS:AIOS_CODE, 

, DS:AIOS_DATA 

ENHANCEMENT 

EQU 

6 

;Offset to fetch parameters 

POP_PARMS 

EQU 

2 

;Total parameters size (in bytes) 
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PUBLIC ENH_AREA 
ENH AREA PROC FAR 


PUSH BP 

MOV BP,SP 

PUSH DS 


MOV AX,AIOS_DATA 

MOV DS,AX 


MOV AL,ENHANCEMENT[BP] 

MOV BYTE PTR ENHANCE,AL 


MOV AX,AIOS_ENTRY 

MOV BX,AIOS_HANDLE 

MOV CX,AIOS_LEN 

MOV DX,OFFSET AIOS_CMD 

INT MSDOS 


POP 

POP 

RET 

ENH_AREA 
AIOS CODE 


DS 

BP 

[POP_PARMS] 

ENDP 

ENDS 


;ENH_AREA entry point 


;Save Incoming BP 

;Set up BP to read param 

;Save incoming DS 

;Set DS to specified data area 


;Get specified enhancement code 
;Put enhancement in AIOS buffer 

;Set up parameters for the 
; call 


;Go enhance the area 

;AX = 0 implies the function 

; was successful 


;Restore incoming registers 


;Toss parameters and return 


END 
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READ AREA 


FUNCTION READ AREA( 

ARRAY LEN: 

INTEGER; 

VAR 

CHARACTERS: 

CHAR; 

VAR 

CHAR SETS: CHAR; 


VAR 

ENHANCEMENTS: 

CHAR):INTEGER 


This function reads characters, enhancements, and or 
character sets from the previously defined area of the screen. 


ARRAY_LEN - 
CHARACTERS - 

ENHANCEMENTS - 
CHAR SETS - 


The length of the array(s) 

Offset pointing to the first location for a 
character to be returned from the area 
Offset of the first enhancement code 
Offset of the first chararter set code 


READ_AREA - Returns 0 if the call was successful 

If the first character is OFFH, then this routine assumes that 
there aren’t any data associated with that parameter. The 
segment will be set to -1 to tell AIOS to ignore that parmeter. 


AIOS ENTRY 

EQU 

UU03H 

;I/0 control write 

AIOS HANDLE 

EQU 

1 

;Console device handle 

MSDOS 

EQU 

21H 

;MSDOS entry point 

AIOS DATA 

GROUP 

AIOS DATA 


AIOS_CODE 

GROUP 

AIOS_CODE 


AIOS_DATA 

SEGMENT 

BYTE PUBLIC 

*AIOS_DATA’ 


ASSUME 

DS:AIOS_DATA 


AIOS CMD 

DW 

5 

;Read Area function code 

DATA_LENGTH 

DW 

? 

;Length of the data arrays 

ENH PTR 

DD 

? 

;Points to enhancement codes 

CHAR SET PTR 

DD 

? 

;Points character set codes 

ASCII_PTR 

DD 

? 

;Points to characters 

AIOS LEN 
AIOS_DATA 

EQU 

ENDS 

$-AIOS_CMD 

;Length of the AIOS buffer 

AIOS_CODE 

SEGMENT 

BYTE PUBLIC ’ 

AIOS CODE’ 


ASSUME 

CS:AIOS_CODE, 

DS:NOTHING, ES:AIOS DATA 
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ARRAY_LEN 

EQU 12 

CHARACTERS 

EQU 10 

CHAR SETS 

EQU 8 

ENHANCEMENTS 

EQU 6 

POP_PARMS 

EQU 8 

READ_AREA 

PUBLIC READ AREA 
PROC FAR 

PUSH 

BP 

MOV 

BP,SP 

PUSH 

DS 

MOV 

BX,AIOS DATA 

MOV 

ES,BX 

CLD 

MOV 

DI,OFFSET ENH_PTR 

MOV 

SI,ENHANCEMENTS[BP] 

CALL 

LOAD PARM 

MOV 

SI,CHAR SETS[BP] 

CALL 

LOAD PARM 

MOV 

SI,CHARACTERS[BP] 

CALL 

LOAD_PARM 

ASSUME 

DS:AIOS DATA 

MOV 

DS,BX 

MOV 

AX,ARRAY LEN[BP] 

MOV 

DATA_LENGTH,AX 

MOV 

AX,AIOS ENTRY 

MOV 

BX,AIOS HANDLE 

MOV 

CX,AI0S LEN 

MOV 

DX,OFFSET AIOS CMD 

INT 

MSDOS 

POP 

DS 

POP 

BP 

RET 

[POP PARMS] 

READ AREA 

ENDP 


;Offset to fetch parameters 
; on the stack 


;Total parameter size (in bytes) 
;READ_AREA entry point 

;Save Incoming BP 

;Set up BP to read parameters 

;Save incoming DS 

;Set ES to specified data area 


;Set flag to increment index 
;Point to specified data structure 

;Set up enhancement pointer 

;Set up character sets pointer 

;Set up characters pointer 


;Set DS to specified data structure 
;DS still has AIOS_DATA 

;Move length into AIOS buffer 


;Set up parameters for the 
; call 


;Read screen data & return 
; completion code 
;Restore incoming registers 

;Toss parameters and return 
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Function Call Examples 


;The following routine moves the pointer from (DS:SI) to (ES:DI) 


LOAD PARM 


CMP 

JZ 

MOV 

MOV 

ADD 

RET 


PROC 


NEAR 


BYTE PTR [SI], OFFH 

NULL_PTR 

ES:[DI],SI 

ES:[DI+2],DS 

DI,U 


;This proc sets up the AIOS pointer 
;DS:SI) It is placed in ES:DI 
;Is 1st byte OFFH (A null pointer 
;YES - put null into AIOS buffer 
;No, put the pointer (DS:SI) 

; in the AIOS command 
;Adjust ES:DI for next pointer 


NULL_PTR: 

MOV AX,OFFFFH 

STOSW 

STOSW 

RET 

LOAD PARM ENDP 


;OFFFFH indicates a null 
;Put a null pointer into 
;AIOS buffer and advance -index 


AIOS_CODE 

END 


ENDS 
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SHIFT AREA 


*************************************************************************** 


FUNCTION SHIFT_AREA( ARRAY_LEN: 

DIRECTION: 

DISTANCE: 

VAR CHARACTERS: 
VAR CHAR_SETS: 

VAR ENHANCEMENTS: 


INTEGER; 
INTEGER; 
INTEGER; 

CHAR; 

CHAR; 

CHAR):INTEGER; 


This function shifts the defined area (if characters, character 
sets, or enhancements are supplied, they will be assigned to the 
vacated area). 


ARRAY_LEN - 
DIRECTION - 
DISTANCE - 
CHARACTERS - 
ENHANCEMENTS 
CHAR SETS - 


The length of the array(s) 

Shift direction; 0: up, 1: down, 2: left, 3: right 

Number of rows or columns to shift 

Character pointer 

Enhancement pointer 

Character Set pointer 


SHIFT AREA - 


Returns 0 if the call was successful 


When the first character of CHARACTERS, CHAR_SETS, or ENHANCEMENTS 
is OFFH, the AIOS pointer will be set null (segment is OFFFFH). 

**##***###*#**#*****#*#******#**#*##****<mhhhhhhhmhhhhhhmhhhhhmmhhh»******** 


AIOS ENTRY 

EQU 

UU03H 

AIOS HANDLE 

EQU 

1 

MSDOS 

EQU 

21H 


;I/0 control write 
;Console device handle 
;MSDOS entry point 


AIOS DATA GROUP AI0S_DATA 

AIOS CODE GROUP AIOS CODE 


AI0S_DATA SEGMENT BYTE PUBLIC ’AIOS_DATA’ 

ASSUME DS:AIOS DATA 
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AIOS CMD 

DW 

6 

DATA LENGTH 

DW 

7 

ENH PTR 

DD 

? 

CHAR SET PTR 

DD 

? 

ASCII PTR 

DD 

7 

SHIFT DIST 

DB 

7 

SHIFT DIR 

DB 

7 

AIOS LEN 

EQU 

$-AIOS_CMD 

AIOS_DATA 

ENDS 


AIOS_CODE 

SEGMENT 

BYTE PUBLIC 


ASSUME 

CS:AIOS_CODE 

ARRAY LEN 

EQU 

16 

DIRECTION 

EQU 

Ik 

DISTANCE 

EQU 

12 

CHARACTERS 

EQU 

10 

CHAR SETS 

EQU 

8 

ENHANCEMENTS 

EQU 

6 

POP_PARMS 

EQU 

12 


PUBLIC 

SHIFT AREA 

SHIFT_AREA 

PROC 

FAR 

PUSH 

BP 


MOV 

BP,SP 


PUSH 

DS 


MOV 

BX,AIOS 

DATA 

MOV 

ES ,BX 



;Shift Area function code 
;Length of the data arrays 
;Points to enhancements 
;Points the character sets 
;Points to characters 
;Number of rows or columns to shift 
;Direction to shift 
;Length of the AIOS buffer 


AIOS_CODE * 

DS:NOTHING, ES:AIOS_DATA 
;Offset to fetch parameters 


;Total parameter size (in byte) 
;SHIFT_AREA entry point 

;Save Incoming BP 

;Set up BP to read parameters 

;Save incoming DS 

;Set ES to specified data area 


CLD 

MOV DI,OFFSET DATA_LENGTH 

MOV AX,ARRAY_LEN[BP] 

STOSW 

MOV SI,ENHANCEMENTS[BP] 

CALL LOAD_PARM 

MOV SI,CHAR_SETS[BP] 

CALL LOAD_PARM 

MOV SI,CHARACTERS[BP] 

CALL LOAD_PARM 

MOV AL,DISTANCE[BP] 

STOSB 

MOV AL,DIRECTION[BP] 

STOSB 


;Set flag to increment index 
;Point to specified data structure 

;Get array length from stack 
;Move array length into AIOS buffer 
;Set up enhancement pointer 

;Set up character sets pointer 

;Set up characters pointer 


Move distance parmeter into 
AIOS buffer 

Move the direction parmeter 
into the AIOS buffer 


C-15 





AGIOS Function Call Examples 


MOV 

DS ,BX 

;Set DS to specified data segment 
;DS still has AIOS_DATA 

MOV 

AX,AIOS ENTRY 

;Set up parameters for the call 

MOV 

BX,AIOS HANDLE 


MOV 

CX,AIOS LEN 


MOV 

DX,OFFSET AIOS_CMD 


INT 

MSDOS 

;Shift the area & set return 
; status 

POP 

DS 

;Restore incoming registers 

POP 

BP 

;Toss parameters and return 

RET 

[POP PARMS] 

SHIFT AREA 

ENDP 


;The following procedure moves the pointer from (DS:SI) to (ES:DI). 


LOAD PARM PROC NEAR 


;This procedure sets up the data pointer 


CMP BYTE PTR [SI],OFFH 

JZ NULL_PTR 

MOV ES:[DI],SI 

MOV ES:[DI+2],DS 

ADD DI,4 

RET 


;Is first byte OFFH? 

;YES - put null into AIOS buffer 
;NO - put the pointer (DS:SI) 

; in the AIOS buffer 
;Adjust ES:DI for next pointer 


NULL PTR: 

“ - OFFFFH indicates a null 

Put a null pointer into 

AIOS buffer and advance index 

RET 

LOAD_PARM ENDP 

AIOS_CODE ENDS 

END 


MOV 

STOSW 

STOSW 


AX,OFFFFH 
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Examples 


WRITE LINE 


FUNCTION WRITE_LINE( 

ARRAY LEN: 

INTEGER; 


COLUMN: 

INTEGER; 


ROW: 

INTEGER; 

VAR 

CHARACTERS: 

CHAR; 

VAR 

CHAR SETS: 

CHAR; 

VAR 

ENHANCEMENTS: 

CHAR):INTEGER 


This function writes characters, enhancements, and or 
character sets to a specified line on the screen. 


ARRAY_LEN - 
ROW - 

COLUMN - 
CHARACTERS - 
ENHANCEMENTS 
CHAR SETS - 


The length of the array(s) 

The row number where the write will begin 
(Remember that rows & columns are 0 based.) 
The column number where the write will begin 
Pointer to the first character 
Pointer to the first enhancement code 
Pointer to the first chararter set code 


WRITE_LINE - Returns 0 if the call was successful 

If the first byte of CHARACTERS, ENHANCEMENTS, or CHARJSETS is 
OFFH, then a null pointer will be passed to AIOS. 


AIOS ENTRY 

EQU 

U403H 

;I/0 control write 

AIOS HANDLE 

EQU 

1 

;Console device handle 

MSDOS 

EQU 

21H 

;MSDOS entry point 

AIOS DATA 

GROUP 

AIOS DATA 


AIOS CODE 

GROUP 

AIOS CODE 


AIOS DATA 

SEGMENT 

BYTE PUBLIC ' 

’AIOS_DATA’ 


ASSUME 

DS:AIOS DATA 
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AIOS CMD 

DW 

7 

;Write Line function code 

COL NUMBER 

DB 

7 

;Column number to start 

ROW NUMBER 

DB 

7 

;Row number to start 

DATA LENGTH 

DW 

7 

;Length of the data arrays 

ENH_PTR 

DD 

7 

;Points to enhancements 

CHAR SET PTR 

DD 

7 

;Points to character sets 

ASCII PTR 

DD 

7 

;Points to characters 

AIOS LEN 

EQU 

$-AIOS_CMD 

;Length of the AIOS buffer 

AIOS_DATA 

ENDS 



AIOS_CODE 

SEGMENT 

BYTE PUBLIC 1 

’AIOS CODE’ 


ASSUME 

CS:AIOS_CODE. 

, DS:NOTHING, ES:AIOS_DATA 

ARRAY LEN 

EQU 

16 

;Offset to fetch input parameters 

ROW 

EQU 

lU 


COLUMN 

EQU 

12 


CHARACTERS 

EQU 

10 


CHAR SETS 

EQU 

8 


ENHANCEMENTS 

EQU 

6 


POP_PARMS 

EQU 

12 

;Total parameter size (in bytes) 


PUBLIC 

WRITE LINE 

;WRITE_LINE entry point 

WRITE_LINE 

PROC 

FAR 


PUSH 

BP 


;Save Incoming BP 

MOV 

BP,SP 


;Set up BP to read parameters 

PUSH 

DS 


;Save incoming DS 

MOV 

BX,AIOS 

_DATA 

;Set ES to specified data area 

MOV 

ES,BX 




CLD 

MOV 


DI,OFFSET COL_NUMBER 


;Set flag to increment index 
;Point to specified data structure 


MOV AL,COLUMN[BP] 

STOSB 

MOV AL ,ROW[BP] 

STOSB 

MOV AX,ARRAY_LEN[BP] 

STOSW 

MOV SI,ENHANCEMENTS[BP] 

CALL LOAD_PARM 

MOV SI,CHAR_SETS[BP] 

CALL LOAD_PARM 

MOV SI,CHARACTERS[BP] 

CALL LOAD PARM 


;Move row number into the 
; AIOS buffer 

;Move column number into AIOS buffer 
;Move data length into AIOS buffer 
;Set up enhancement pointer 
;Set up character set pointer 
;Set up character pointer 
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ASSUME 

DS:AIOS DATA 

MOV 

DS,BX 

MOV 

AX,AIOS ENTRY 

MOV 

BX,AIOS HANDLE 

MOV 

CX,AIOS LEN 

MOV 

DX,OFFSET AIOS CMD 

INT 

MSDOS 

POP 

DS 

POP 

BP 

RET 

[POP PARMS] 


;Set DS to specified data area 
;DS still has AIOSJDATA 

;Set up parameters for the call 


;Write line and return completion 
; status 

;Restore incoming registers 
;Toss parameters and return 


WRITE_LINE ENDP 

* 

;The following procedure moves the pointer from (DS:SI) to (ES:DI). 


LOAD_PARM 

CMP 

JZ 

MOV 

MOV 

ADD 

RET 


PROC NEAR ;This routine moves a pointer 

;into the AIOS buffer 

BYTE PTR [SI],0FFH ;Is first byte OFFH? 

NULL_PTR ;YES - put null into AIOS buffer 

ES:[DI],SI ;N0 - put the pointer (DS:SI) 

ES:[DI+2],DS ; into the AIOS buffer 

DI»U ;Adjust ES:DI for next pointer 


NULL_PTR: 

MOV AX,OFFFFH 

STOSW 

STOSW 

RET 

LOAD PARM ENDP 


;OFFFFH indicates a null 
;Put a null pointer into 
; AIOS command and advance index 


AIOS CODE ENDS 


END 
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APPENDIX D 


GRAPHICS CONTROL FUNCTIONS 




Introduction v. 


This section contains a description of the terminal's graphic functions and 
how they are used. The information and the examples are intended for 
use in developing programs to control the graphics functions. Additional 
information on how to use the graphics features from the keyboard is 
contained in the HP150 Terminal User's Guide. 
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Graphics Display 

You can display graphics data by addressing points in a 512 by 390 array. 


0,389 511 > 389 



The graphics and alphanumeric data are displayed in the same area on the 
screen but are stored in separate RAM memories. This allows you to read 
or modify graphics and alphanumeric data separately. 


NOTE 

Alphanumeric characters overlay or mask out the graphics display. Thus 
enhancements (blinking, inverse video, etc.) alter the appearance of 
graphics already on the screen. The data in the graphics display memory, 
however, remains unchanged. 
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Keyboard Graphics Functions 

Graphics functions commands in the form of escape sequences can be 
entered at the terminal keyboard by the operator. In addition, certain 
graphics functions are performed via the set of graphics control keys 
located to the right of the normal ASCII character set (see figure D-l). 
Table D-l contains a list of the keys and a description of their functions. 
These keys function in either local or remote operation. This allows a 
combination of operator and program control of graphics functions. Refer 
to the HP150 Terminal User's Guide for detailed information on using 
the graphics control keys. 



CURSOR FAST 


Figure D-l. Location of Graphics Keys 

Each key (except the TAB key, the decimal point key, and the 4, 6,7,8, and 
9 keys) performs one of two functions, depending upon the current state 
of the keypad. Pressing 1 ctrl |, and the 0 key on the graphics keypad 
toggles the keypad between graphics and numerics functions. The current 
state of the keypad appears as Grph Pad or Mum Pad in the status line at 
the bottom of the screen display (the 27th row). The default state is Num 
Pad. The current state of the keypad, however, is stored in non-volatile 
memory; if you set the keypad to Grph Pad and turn off the terminal, the 
keypad is still in GRAPH PAD state when you reapply power. Some 
applications will change the state of the keypad as needed. Hard reset 
( I shift || ctrl H reset | ) does not affect the keypad state. 
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You can set the keypad programmatically using the command: 

EC & k <parameter> o 
where <parameter> may be: 

0 = Num Pad 
1 = Grph Pad 

While in Grph Pad, the cursor control keys are the only repeating keys. 
Also, in Grph Pad the minus key on the Num Pad and the 1 tab |, □, and 4, 
6, 7, 8, and 9 keys are disabled. 


Table D-l. Graphics Control Keys 


KEY 

DESCRIPTION 

Graph cursor 

Toggles the graphics cursor on and off. 

f - 

Move the graphics cursor. More than one key can be pressed 


for diagonal motion. 

Cursor fast 

Speeds up the graphics cursor if pressed in conjunction with 
the cursor keys. The rate returns to normal when released. 

Graph display 

Toggles the graphics display to inhibit the graphics image 
without erasing. 

Alpha display 

Toggles the alphanumeric display to inhibit the alphanumeric 
image without erasing. 

Graph clear 

Erases the graphics image memory. 

* Graph copy 

Copies graphics memory to the specified "to” devices. 

° 

Toggles the function of the keypad between graphics and 
numerics whenfJU is pressed simultaneously. 

° 

Unshifted in numeric mode, the key is used to display a minus 
(-) character. 


:: The Graph copy key causes an error message to appear if no valid destination device is specified. 
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Syntax Notations for Graphics Escape 
Sequences 

All terminal graphics functions can be accomplished through escape 
sequences. An escape sequence is a series of ASCII characters preceded by 
the escape character. The escape character signals the terminal that the 
succeeding characters form a command. 

The two general forms of the graphics escape sequences are: 

Ec * <FG> <FL> or <FU>, 

Ec * <FG> I <decimal parameter> I <FL> or <FU> 

<FG> is the Function Group or family indicator which must be 
a lower case character from the set (a,b,c ... z). For 
example: 

Ec*d sequences are display commands 
Ec*p sequences are plotting commands. 

I I encloses one or more decimal parameters separated by 
spaces or commas. For example: 

Ec*p <cx>,<cy>Z is a plotting command 
Ec*pb 194, 250Z is the command to draw a vector 
from the current pen position to 
194,250. 

<> are angle brackets that always enclose character 
parameters. For example: 

Ec*m<x>,<y>j sets the relocatable origin in 
absolute coordinates 

Ec*m 255,294J sets the absolute relocatable origin 

at 244,194. 

<FL> is a Lower case Function terminator from the set 
(a,b,c ... z). For example: 

Ec*d <z>k turns on the graphics cursor. 

If <FL> is used to terminate a function, other function 
terminators from the same family or function group may 
be appended to the sequence until an upper case 
terminator <FU> is used. 
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FU> is an Upper case Function terminator from the set 
(A,B,C ... Z, and A ). If <FU> is used, it terminates 
both the function and the escape sequence. 

An escape character will also terminate this function and 
the escape sequence. For example: 

Ec*p<cx>,<cy>Z - "Z" ends the sequence 
Ec*m<x>Q - "Q" ends the sequence. 


NOTE 

Ec* 1 (label) commands are terminated by carriage return, linefeed, or the 
escape character. 


Miscellaneous Characters 

No spaces are allowed among the first three characters of the escape 
sequence (for example Ec*d) but spaces after these are ignored (except in 
character parameters). Carriage returns and line feeds are ignored after 
the first three characters (except in the label commands — Ec*l). 


Table D-2. Summary of Graphics Sequence Types 


Escape Sequence 

Description 

Ec * d 

Display Control 

Ec * 1 

Labeling 

Ec * m 

Drawing Mode 

Ec * p 

Vector Plotting 

Ec * 5 

Graphics Status 

Ec * t 

Compatibility Mode 

Ec * w 

Graphics Initialization 
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Control Codes 

Control codes are generally ignored, with the exception of the ESCAPE 
character (Ec). If an Ec character is detected and the previous graphics 
control sequence has not been properly terminated with a "Z" or some 
other valid upper case character, the Ec will abort execution of the previous 
sequence and the new escape sequence will be executed. 


Graphics Display Control 

Graphics display control is made up of the functions used to control the 
graphics cursor, the portion of the graphics memory that is currently 
being displayed, or the state of the graphics memory. These functions are 
as follows: 

• Graphics Cursor Control 

• Graphics Memory Control 

Table D-3 lists the escape sequences for the graphics display control 
functions. 


Table D-3. Graphics Display Control Functions 


FUNCTION 

CODE 

DESCRIPTION 

Graphics Cursor Control 



Cursor On 

Cursor Off 

Move Absolute 

Move Relative 

Ec*dk 

Ec«dl 

Ec *d<x > ,< y>o 

Ec *d<x > »<y>p 

Turn on the graphics cursor. 

Turn off the graphics cursor. 
Position the graphics cursor. 
Position the graphics cursor. 

Graphics Memory Control 



Clear Memory 

Ec *da 

Turn off all dots in graphics 

Set Memory 

Ec *db 

memory. 

Turn on all dots in graphics 

Display On 

Display Off 

Ec «dc 

Ec *dd 

memory. 

Enable the graphics display. 
Inhibit the graphics display. 


See the end of this chapter for a complete list of Graphics escape 
sequences. 
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Graphics Cursor Control 

A separate graphics cursor is available for use in locating points in the 
graphics display. The graphics cursor is used by the terminal operator to 
input position data or to interact with a graphics application program. 

GRAPHICS CURSOR ON /OFF. The graphics cursor is initially off 
(power on or full reset). Turning the cursor on or off does not affect the 
data in graphics memory. 

The graphics cursor may be toggled on and off by pressing the Graph 
cursor key on the graphics/numeric pad. 

Programmatically, you can toggle the cursor: 

Graphics Cursor On: E c * d k 

Graphics Cursor Off: E c * d 1 

GRAPHICS CURSOR POSITIONING. The graphics cursor is initially 
at position (0,0) after power on, full reset, graphics hard reset (Ec*wr), or 
graphics default reset (Ec*mr). You can position the cursor (even if it is 
not turned on) using either absolute or relative coordinates. In the 
following sequences, X and Y give the new cursor position. Refer to 
Vectors for a discussion of absolute and relative coordinates. 

Position Graphics 

Cursor Absolute: Ec*d<X>,<Y>o 

Position Graphics 

Cursor Relative: Ec*d<X>,<Y>p 

You can position the graphics cursor with the graphics/numeric keypad 
by pressing ■*, *, •+•, +. Pressing two keys simultaneously causes 
diagonal movement. The Cursor fast key can be pressed at the same 
time for high-speed cursor positioning. 

Example: The cursor is currently at position 100,100 and off. Move it 50 
units to the right and 20 units down from its current position and turn it 
on. 


(Before) 



(After) 


r 





\ 

(100,100) 




— 50— 




0 


/ 

/ 

/ 

/ 

-20 

V 

) 



(150,80) 

J 

EC • d 50, - 20 pK 
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Graphics Memory Control 

The graphics display can be turned on or off or the entire memory can 
be set to all ones (dots on) or all zeros (dots off). 

GRAPHICS DISPLAY ON/OFF. The graphics display and graphics 
cursor can be turned on or off. The data in the graphics memory is 
unaffected. 

From the graphics/numeric keypad, pressing Graph display toggles the 
graphics display on and off: 

Programmatically: 

Graphics Display On: E c * d c 

Graphics Display Off: E c * d d 

GRAPHICS DISPLAY SET /CLEAR. The graphics data currently 
displayed on the screen can be set to all ones (a white screen) or cleared 
to all zeros (a black screen). 

Clear Graphics Memory: E c * d a 

Set Graphics Memory: E c * d b 

You can clear graphics data on the screen from the keyboard by pressing 
Graph clear on the graphics/numeric pad. 


Graphics Drawing Mode Parameters 

There are several drawing parameters that can be set to allow a wide 
variety of drawing capabilities. These parameters select whether points 
will be turned on or turned off, define line or area patterns, position the 
relocatable origin, and define graphics text settings. 
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Graphics drawing mode control sequences begin with Ec # m followed 
by one or more of the drawing parameters. Table D-4 lists the mode 
control commands. 


Table D-4. Graphics Mode Commands 


Ec * m <parameters> 

PARAMETERS 

DESCRIPTION 

a 

select drawing mode 

b 

select line type 

c 

define user line pattern 

d 

define user area fill pattern 

e 

rectangular area fill, absolute 

f 

rectangular area fill, relocatable 

9 

select area fill pattern 

h 

select area boundary pen 

j 

set relocatable origin to absolute coordinates 

k 

set relocatable origin to current pen position 

1 

set relocatable origin to graphics cursor position 

m 

set graphics text size 

n 

set graphics text direction 

o 

turn on character slant 

P 

turn off character slant 

q 

set text origin 

r 

set graphics defaults 

z 

NOP 


Drawing Modes 

Vectors can be drawn by setting, clearing, or complementing the data in 
the graphics memory. Normally the memory is cleared and vectors are 
drawn by setting selected bits to make green lines on a dark screen. If 
instead you want black vectors on a green screen, you can begin by 
setting memory (refer to the section on Graphics Memory Control 
above), select a clear or complement line type and draw dark vectors 
(refer to the example that follows). Figure D-2 illustrates the various 
drawing modes. 

Set Drawing Mode: Ec * m <parameter> a 

where: <parameter> is 

0 = no effect 

1 = Clear (turn off graphics bits) 

2 = Set (turn on graphics bits) 

3 = Complement (toggle the graphics bits) 

4 = Jam (turn bits on or off according to the data) 
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v.___y 

Mode 0 (No effect on original screen) 



Mode 1 (Clear mode-erases the parts of 
the pattern in the original screen) 




Mode 4 (Jam mode-the same as set 


mode on this terminal) 


Figure D-2. Examples of Drawing Modes 
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CLEAR MODE. Clear mode causes selected display bits to be turned off. 
The "selected bits" are those that are "on" in the line pattern. If a solid 
line type (the default) has been selected, all of the bits in a vector will be 
selected. In clear mode this means that all of the dots making up a vector 
will be turned off. This allows you to draw dark vectors on a white 
background. Only those bits that are in the pattern are cleared. Bits that 
are off in the pattern do not affect the display. 

SET MODE. Set mode is similar to clear mode except that the selected 
bits are turned on instead of off. Only the bits that are on in the line type 
are affected. 

COMPLEMENT MODE. Complement mode causes the selected display 
bits to change state (on to off, off to on). Again only those bits that are on 
in the line type or pattern are affected. 

JAM MODE. Jam mode functions identically to Set Mode on the HP150 
system; it has been included for compatibility with other HP systems. 

SELECTIVE ERASE. A vector drawn in set mode can be selectively 
erased by redrawing it in clear mode. This will cause gaps to occur if the 
erased line is intersected by other lines. This problem can be overcome 
by initially drawing the line in complement mode and then redrawing it 
in complement mode to erase the line. This technique will preserve the 
original display. Complement mode is useful for drawing and erasing 
temporary figures. 

Example : Select complement mode, draw a vector, and then erase the 
vector by redrawing. 

Ec * m 3 A (select complement mode) 

Ec * p a 100,300 300.300Z (draw vector) 

Ec * p a 100,300 300.300Z (erase vector) 

Drawing Patterns 

You can select the dot pattern used when drawing vectors or filling 
rectangular areas. Dotted and dashed lines can be drawn by selecting 
one of nine predefined line patterns or a user defined line or area 
pattern. This allows you to use different line patterns to distinguish 
between groups of plotted data or easily generate shading and cross 
hatching for use in engineering drawings, graphs or fabric patterns. 
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LINE TYPE. One of eleven line types can be selected. Once a line type 
has been selected, all drawing vectors are drawn using that line type. 
The patterns for the predefined line types are shown in figure D-3. 
Refer to the Define Line Pattern command for additional information. 


Select Line Type: Ec * m <line 

where: <line type> is 

1 Solid line (default) 

2 User defined line pattern 

3 Current area pattern 

4 Predefined pattern #1 

5 Predefined pattern #2 

6 Predefined pattern #3 

7 Predefined pattern #4 

8 Predefined pattern #5 

9 Predefined pattern #6 

10 Predefined pattern #7 

11 Point plot 


type> b 

1 = - 

4 =- 

5 =- 

6 =- 

7 = . 

8 = - 

9 = . 

10 -- 

11 = • (POINT PLOT) 


Figure D-3. Line Drawing Patterns 


Point plot causes a single point to be plotted at the coordinates specified 
by the data. This line type is useful for generating "scattergram" type 
graphs. If current area shading is selected (type = 3) the line patterns 
used are selected from the eight lines making up the area fill pattern 
(refer to Define Area Pattern). The display is divided into groups of eight 
rows and eight columns. Horizontal and vertical lines are drawn using 
the appropriate row or column from the area pattern. Diagonal lines are 
drawn using a solid vector. See the Illustration below. 


128 64 32 16 8 4 2 1 




(B) Display 
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Figure D-4. Using Area Patterns as Line Types 















Ec * m 240 15 240 15 240 15 240 15 D 

Defines the user- 
definable fill pattern to 
that shown in Figure D-4A. 

Ec * m 2 G Sets the current area 

fill pattern to the user- 
defined area pattern 

Ec * m 3 B Sets the current line 

type to the current area 
fill pattern. 


Ec * pa 200,150 300 , 

300,250 Z 


50 


300,250 200,250 200,150 

Draws the vectors 
shown in Figure D-4B. 


NOTE 

Only horizontal and vertical vectors can be defined with an area pattern. 
All diagonal vectors are drawn as a solid line. 


Adjacent horizontal or vertical lines using the user defined line type 
(type = 2) can be used to create patterns more complicated than those 
available in an 8X8 area pattern. User defined line and area patterns are 
described in the following paragraphs. 

USER-DEFINED LINE PATTERN. The dot pattern used to draw 
vectors can be defined programmatically. Once a pattern is defined, you 
must select the user defined line type (type = 2) using the Select Line 
Type command. Figure D-5 gives examples of line patterns. 

A user-defined line pattern is composed of a dot pattern and a scale 
factor. The dot pattern is a sequence of eight l's and 0's. Using the default 
drawing mode, points indicated as a "l" in the pattern are drawn using 
the primary pen, and the points indicated as a '0" are left unchanged. 

The pattern is given as a decimal number between 0 and 255 that is the 
decimal equivalent of the 8-bit binary pattern. The default pattern is all 
"l"s (255). For example, ... = 10101010 (binary) = 170 (decimal). The 
actual number used for the pattern can be between -32768 and 32767. 
The least significant 8 bits of the number's 2's complement equivalent 
are used to determine the pattern. 
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The scale factor indicates how many times each bit in the pattern is 
repeated. The default scale factor is 1. For example, a scale factor of 3 

applied to the pattern defined above results in a pattern of. 

111000111000111000111000 (binary). 

The command for creating a user-defined line type is: 

Ec * m <pattern><scale>c 

where <pattern> is an integer in the range (-32768 and 32767) and 
< 5 ca 1 e> is an integer in the range (0 to 255 modulo 16). 

Example: Define a pattern to generate the following vector: 

11111111110011001111111111001100 
pattern = 11111010 = 250 
scale — 2 
Ec * m 250 2 C 

The result is displayed in the fourth user-defined line in Figure D-5 
below. 



Figure D-5. Examples of User-Defined Line Types 
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Line patterns too complex to be obtained from an 8 X 8 area pattern can 
be generated by plotting a series of lines and varying the patterns used 
for successive lines. Complex patterns such as those used in weaving can 
be generated easily using this technique. 


Area Fills 

The terminal has two types of area fill specifications — rectangular and 
polygonal. An area can be filled with one of a variety of predefined 
patterns or with a user-defined pattern. The pattern can also be used to 
provide line patterns for horizontal or vertical lines when the area pattern 
is selected as the line type. (Refer to "Using Area Fills As Line Types.") 

When an area fill pattern is selected, the entire screen is divided into 8X8 
cells. Each location is mapped to the corresponding bit in the pattern. 
When an area fill operation is performed, the area fill pattern is 
duplicated to fill the area. The pattern starts at screen coordinates 0,0 (see 
Figure D-6 below). 
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Selecting An Area Fill Pattern 

The default pattern for area fill is a user-defined pattern. To select the 
type of area fill pattern to be used, use the following escape sequence: 

Ec * m <area pattern> g 

where <area pattern>is selected from: 

1 Solid area fill 

2 User defined area fill pattern (default) 

3 Pattern #0 (short dashed hatching) 

4 Pattern #1 (long dashed hatching) 

5 Pattern #2 (hatching) 

6 Pattern #3 (cross hatching) 

7 Pattern #4 (fine cross hatching) 

8 Pattern #5 (medium checkerboard) 

9 Pattern #6 (fine checkerboard, 1:1 blend) 

10 Pattern #7 (3:1 blend) 

User Defined Area Fill Patterns 

The user area pattern is defined by 8 parameters, one for every row of 
dots in the pattern. Each parameter is an integer in the range -32768 to 
32767. The number is interpreted as a 2's complement number, and the 
least significant 8-bits are used to obtain a value between 0 and 255. The 
8-bit number (0 to 255) represents an 8-bit binary pattern. Bits set to 1 are 
drawn using the primary pen, and bits set to 0 (zero) are not drawn 
(depending on the current drawing mode). 

The command for defining a user area fill pattern is: 

Ec * m <row 0><row 1>. . ,<row 7> d 

where < r o w 0 > is the 8-bit pattern for row 0 


< r ow 7 > is the 8-bit pattern for row 7 
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Example : Define the simple checkerboard pattern seen in Figure D-8 
below. 

Ec * m 170 85 170 85 170 85 170 85 D 
Row 0 Row 7 


NOTE 

The scale factor of an area fill pattern is always 1. This resembles the HP 
2627A but is unlike all other Hewlett Packard terminals. 


Other examples of user defined area patterns are shown in Figure D-7 
below. 


64 16 4 1 

128 32 8 2 



64 16 4 1 

128 32 8 2 

60 
66 
129 
129 
129 
129 
66 
60 
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Using Area Fill Patterns as Line Types 

If you select type 3 for the Line Type command, the line pattern is 
created from the current area fill pattern. Horizontal and vertical lines 
are drawn using the appropriate row or column from the area fill 
pattern. Diagonal lines are always drawn using a solid vector; they do 
not follow the area fill pattern. If a line is longer than 8 dots, the pattern 
is repeated to complete the vector. 

Example : Plot three vectors (200,150), (300,150 ...) using a user defined 
area fill pattern of 240,15,240,15 (Figure D-8 below). 


128 64 32 16 8 4 2 1 




(B) Display 


Figure D-8. Using Area Fill Patterns as Line Types 


Ec * m 240 15 240 15 240 15 240 15 D 

Defines the user- 
definable fill pattern to 
that shown in Figure D-8 A. 


Ec * m 2 G 


Sets the current area 
fill pattern to the user- 
defined area pattern 


Ec * m 3 B 


Sets the current line 
type to the current area 
fill pattern. 


Ec * pa 200,150, 300,150, 
300,250 Z 


300,250 200,250 200,150 

Draws the vectors 
shown in Figure D-8B. 
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Rectangular Area Fills 

A rectangular area can be filled in with a pattern simply by sending the 
lower left and upper right coordinates in an escape sequence. The 
coordinates can be either in absolute or relocatable ASCII format. The 
pattern used for area fill is determined by the Select Area Pattern 
command. 


NOTE 

The terminal can also fill irregular polygons. See "Polygonal Area Fills" 
in this section. 


FILL RECTANGLE, ABSOLUTE: 

Ec * m <x 1 ><y 1 Xx2><y2> e 

where < x 1 > < y 1 > are the absolute coordinates of the lower left corner of 
the rectangle area to be filled ( — 16384 to +16383), and <x2xy2> are the 
absolute coordinates of the upper right corner of the rectangular area to 
be filled (-16384 to +16383). 

Example : Using area fill pattern 5, fill a rectangle defined by the 
diagonal 50,50 300,300. 

Ec * m 5 g 50,50 300,300 E 

FILL RECTANGLE, RELOCATABLE: 

Ec * m <x1>,<y1><x2>,<y2> f 

where <x 1 > and <y 1 > are the relocatable coordinates of the lower left 
corner of the rectangular area to be filled (-16383 to 16383), and <x2> and 
<y2> are the relocatable coordinates of the upper right corner of the 
rectangular area to be filled (-16383 to 16383). 

This command is used in conjunction with the relocatable origin. 

Example : Load a function key with the command: 

Ec * m 1 20,20 30,30 F 

Use the cursor control keys to move the graphics cursor while 
periodically pressing this function key. 
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Polygonal Area Fills 

Begin Polygon Area Fill: Ec # p s 

Close Polygon/Begin New Polygon: Ec * p a 

Close Polygon Area Fill: Ec * p t 

You can define a polygon with as many as 105 sides and fill the shape 

with the current area fill pattern. The Begin Polygon Area Fill command 
causes subsequent coordinate pairs to be read as vertices of the polygon. 
When a lift pen command (Ec * p a) occurs in the middle of a polygon 
area fill sequence, a new polygon is started (see example). The Close Area 
Fill command (or any capital letter) causes the polygon to be filled using 
the current drawing mode and area pattern. Note that it is not necessary 
to specify a vector from the last point back to the first point; the polygon 
automatically closes itself at the end of the sequence. 

If the polygon definition crosses over itself, the areas are defined in 
alternate order. See Figure D-9 and D-10 below. 



Figure D-9. Overlapping Polygon Area Fills 

Examp 1 e : Move the pen to 33.0, and define and fill a pentagon 100 units 
on a side. Lift and move the pen 40 10, and define another pentagon 
inside the first pentagon. 

Ec * p a s 33,0 133,0 166,95 83,150 0,95 
a 40,10 12,91 83,138 153,91 125,10 T 


v Figure D-10. Polygon Area Fill Example 
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NOTE 

When using user-defined softkeys to define polygon area fills, the entire 
polygon specification must be contained within one softkey to avoid loss 
of data. 


Area Boundary Pen 

You can outline a filled area with a solid line by enabling the area 
boundary pen. When the area boundary pen is disabled, the edges of the 
filled area are the same pattern as the interior. 

Set Area Boundary Pen: Ec * mcboundary pen> h 

where <boundary pen> may be: 

0 = enable boundary pen 
No parameter = disable boundary pen 

Graphics Relocatable Origin 

The relocatable origin is a means of adding an offset to the x and y 
coordinate values of data points. The value of the relocatable origin is 
added to the value of the x and y coordinates sent by the host computer. 

The relocatable origin allows you to use one set of data and drawing 
commands to display a figure at several different positions. The value of 
the relocatable origin is added to the relocatable data to obtain the 
coordinates used to draw the figure. 

The terminal provides three commands for setting the graphics 
relocatable origin: 

• Set Relocatable Origin In Absolute Coordinates 

• Set Relocatable Origin To Current Pen Position 

• Set Relocatable Origin to Current Cursor Position 
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Set Relocatable Origin in Absolute Coordinates 

Ec * m<x>,<y>; 

where — 16383 < <x>,<y> <16383 

This command sets the relocatable origin to the coordinates given in 
<x> and <y>. The values of <x> and <y> are in the absolute data 
format. Once the relocatable offset has been added, the resultant data is 
stored in the terminal in absolute format. 

^ * m- 300 -100J 

*1 * p ah300,100 500,100 500,200 300,200 300.100Z 


Relocatable 
Origin = - 300, - 


After 

redrawing 


Figure D-ll. Relocatable Origin, 

Set Relocatable Origin To Current Pen Position 

Ec * mk or Ec * pe 

This command sets the relocatable origin to the current position of the 
graphics pen. This allows you to position the pen using absolute, 
incremental, or relocatable data and then plot a figure at that location 
using relocatable data. 

Set Relocatable Origin To Current Graphics Cursor 
Position 

Ec * ml 

This command takes the absolute coordinates of the virtual graphics 
cursor position as the relocatable origin. 







300,200 

500,200 






300,100 

500,100 





) 


D-23 




























Selecting The Graphics Default 
Parameters 

Graphics parameters can be set to their default (power-on or full reset) 
values (see Table D-5) by issuing the following sequence: 

Ec * m <default flag> r 

It may be necessary to reselect graphics settings before sending graphics 
data to the terminal. See the Status section for further information on 
graphics status requests. 


Graphics Hard Reset 

Graphics hard reset performs as if a hard reset were initiated for graphics 
only. It sets all graphics parameters to their default values as specified for 
Ec * mr (see Table D-5) plus the following: 

1. Clears raster memory buffer 

2. Drawing pen is positioned at location 0,0 

A graphics hard reset can only be performed programmatically: 

Ec * w r 


Table D-5. Graphics Parameter Default Values 


PARAMETER 

DEFAULT VALUE 

**Pen Condition 

down 

**Line Type 

1 (solid) 

** Drawing Mode 

2 (SET) 

**User Line Pattern 

255,1 

**Area Fill Type 

2 (user-defined pattern) 

**User Area Fill Pattern 

255,255,...,(solid) 

** Boundary Pen 

off 

**Text Size 

1 

**Text Direction 

1 

**Text Origin 

1 (left, bottom) 

**Text Slant 

0 (off) 

** Graphics Text 

off 

Relocatable Origin 

0,0 

Graphics Video 

on 

Alphanumeric Video 

on 

Graphics Cursor 

off 

Graphics Cursor 


Address 

0,0 

Rubberband Line 

off 

Alphanumeric Cursor 

on 

Compatibility Mode 


Page Full Straps 

0 (out) 

GIN Strap 

0 (CR only) 


**If a "1” is used for the < default f lag> (Ec*m1 r), only these parameters are defaulted. 
When no default value is used (Ec*mr), all parameters are defaulted. 
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Plotting Sequences 

All vector plotting sequences are initiated by Ec * p Table D-6 lists the 
commands that can be used within a plotting sequence. 

After Ec * p has been sent, the drawing format is normally specified 
before data is sent. 

If no format is specified, ASCII absolute is assumed. There is no explicit 
draw vector command. 

Plotting Commands 

Graphic data is made up of vectors (line segments). There is no explicit 
"draw vector" command. Instead, the terminal uses the concept of a "pen" 
in drawing vector data. 

The general format for a plotting sequence is: 

Ec * p <pen 5 tate> <x1> , <y1> <x2> , <y2> . . . Z (or 

any capital letter) 

where <pen state > indicates whether the pen is up or down, and the 
values are delimited by spaces or commas. The capital "Z" (a non¬ 
operative) terminates the sequence. 


Table D-6. Graphics Plotting Control Functions 


Ec * p <parameter9 and data> 

PARAMETER 

DESCRIPTION 

a 

lift the pen 

b 

lower the pen 

c 

use graphics cursor position as new point 

d 

draw a single dot at the current pen position 

e 

set relocatable origin = current pen position 

f 

use ASCII absolute format 

9 

use ASCII incremental format 

h 

use ASCII relocatable format 

i 

use binary absolute format 

j 

use binary short incremental format 

k 

use binary long incremental format 

1 

use binary relocatable format 

z 

NOP/synch 
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When enough parameter bytes have been received (the number depends 
on the parameter's format) to specify a data point, the pen is moved from 
its current position to the new end point. If the pen is down, a vector 
will be drawn. If the pen is up, the pen is moved to the new point 
(without drawing a vector) and lowered. In either case, the new point 
becomes the current pen position. The following illustration demonstrates 
the current pen position and the new end point. 
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Plotting sequences can extend indefinitely. In general, longer sequences 
are preferred as they minimize the overhead needed for a plot sequence. 
As the sequence length decreases, the percentage of prefix characters 
increases, and the drawing rate goes down. The worst possible case 
would be to send each vector in its own sequence; approximately 50% of 
the characters sent would be overhead, reducing vector speed by a factor 
of 2. 

Note that if a parameter byte is lost or garbled in transmission, all 
following end points will be improperly read. To minimize data errors 
caused by the loss of a data byte, any command can be used to reset the 
parameter count and restore synchronization. Nops (z), redundant 
format, or pen down commands can also be inserted to insure 
synchronization if necessary. 


Lift Pen 

Ec * pa 

This command causes the imaginary plotting pen to be lifted from the 
drawing surface. Movement of the pen from the current position will 
not draw a line. The pen must be lowered (by supplying a coordinate or 
a lower pen command — Ec * pb) before a line can be drawn. 

Example : Lift the pen, move it to 100,100, draw a vector to 200,200 and 
then to 50,300. 

Ec * pa 100,100 200,200 50,300Z 
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NOTE 

This command can also be used in conjunction with polygonal area fill 
commands. See "Polygonal Area Fills" in this chapter. 


Lower Pen 

Ec * pb 

This command causes the imaginary plotting pen to be lowered to the 
drawing surface. Movement of the pen from the current position will 
draw a line. 

Example : Draw a vector from the current pen position to 194,250. 

Ec * pb 194 250Z 

Use Cursor As Next Data Point 

Ec * pc 

This command causes the position of the graphics cursor to be used as 
the next data point. 


Rubberband Line Mode 

Turn Rubberband Line On: Ec * dm 
Turn Rubberband Line Off: Ec * dn 

"Rubberband Line" mode causes the terminal to display a temporary 
line connecting the graphics cursor to the current pen position. As the 
cursor is moved (using the cursor control keys or move cursor 
commands), the temporary line moves, stretches, or contracts as required 
to maintain the connection. The temporary line is "set" when the cursor 
position is entered as a new point by executing the E c * p c command. 
The origin of the temporary rubberband line is then updated to the new 
point and the process can be repeated. 


NOTE 

If the graphics cursor is not already on, activating the rubberband line 
function turns on the graphics cursor. 
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Draw A Point At The Current Pen Position 

Ec * pd 

The command draws a point at the current pen position. The pen is set 
to up. This command is ignored if encountered during an area fill 
sequence. 


Vectors 


Graphics data is made up of vectors. Each vector is specified by the current 
graphic starting point and an end point. The current graphic starting 
point is one of the following: 


0,0 Initial starting point 

Last point defined by the graphics cursor CEc*pc). 

Last point defined by the data in a draw or move command 
(Ec * p f/g/h/i/j/k/1). 


Graphic points are specified in one of the following formats: 


ASCII Absolute 
ASCII Incremental 
ASCII Relocatable 
Binary Absolute 
Binary Incremental 
Binary Short Incremental 
Binary Relocatable 


If no format is specified in the graphic command, ASCII absolute format is 
assumed. More than one point can be given in a command. This 
minimizes communications overhead. Tables D-7, D-8, and D-9 provides 
a reference for computing data bytes used in the various vector formats. 


ASCII Formats 

In the ASCII formats, coordinates are specified with ASCII characters 0 
through 9. This means that numeric characters generated by a simple 
print statement can be used to specify X,Y pairs. The first value is used as 
the X coordinate, and the second as the Y coordinate. 

Spaces or commas must be used to delimit the X and Y values. Excess 
delimiters are ignored. Digits following a decimal point are ignored (i.e. 
123.456 is read as 123). 
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NOTE 

Exponential notation cannot be used. Consequently, the values must be 
in integer form. The number of bytes necessary to specify a single end 
point depends on the magnitude of the values. 


ASCII ABSOLUTE FORMAT. The values used in the ASCII absolute 
format can range between -16384 and 16383. Note that only points where 
X is the range 0 to 511 and Y is the range 0 to 389 will be visible on the 
screen. The following example draws vectors around the perimeter of 
the screen: 


Ec * p a 0,0 511,0 511,389 0,389 0,0Z 


0,389 


0,0 


511,389 


511,0 


Since no format is indicated, ASCII absolute is assumed. The "a" raises 
the pen, which is moved to (0,0) and lowered. Vectors are then drawn to 
(511,0),(511,389),(0,389), and back to (0,0). (Note that the values are 
delimited by spaces or commas. The upper case "Z" [a nop] terminates 
the sequence. Imbedded carriage return and line feed characters are 
ignored.) 

ASCII INCREMENTAL FORMAT. In the ASCII incremental format 
you can specify a delta X and a delta Y. These values are added to the 
current pen position to obtain a new end point. The first value is read as 
delta X and the second as delta Y. For example to draw a square 100 units 
on a side, the following sequence could be used: 

Ec • p g 100, 0 0, 100 -100, 0 0, -100 Z 


100,0 


- 100,0 


0,-100 


0,100 
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Beginning at the current pen position, a series of vectors is drawn by 
moving the pen 100 units to the right, up 100 units, left 100 units, and 
finally down 100 units. The same figure could have been drawn at any 
screen location by first positioning the pen to the desired starting point 
before sending the drawing sequence. 

ASCII RELOCATABLE FORMAT. The ASCII relocatable format allows 
you to use a relocatable origin to be added to the incoming X and Y 
coordinate values. The resultant values are then treated as absolute 
coordinates by the terminal. The relocatable format allows you to use 
absolute data as if it were incremental by merely changing the 
relocatable origin. For example, symbol elements specified in absolute 
coordinates can be drawn in different locations as shown in the 
following example. 

Example : Draw a resistor symbol stored in absolute coordinates at 
screen locations 50,100 and 200,100. 

R**i*tor Data = 0,10 

10,10 

15.15 

25.5 

35.15 

45.5 

50.10 

60.10 

*c ** 50 , 100 J 

^** 0,10 10,10 15,15 25,5 35,15 

45,5 50,10 60,102 

*t *a200,100 J 

10,10 15,15 25,5 35,15 

45,5 50,10 60,102 


0,20 

60,0 

0,0 

60,0 






Binary Format 

In binary format all points are sent in a packed binary format. The 
coordinate values are sent using the bit patterns of the ASCII characters 
listed in Table D-7. The number of characters required to specify a 
coordinate depends on the format used. The Binary data can be long, 
short, or medium. The vectors are made up of 2, 4, or 6 bytes of 
coordinate information. The numbers are represented in a 5-bit per byte 
format. The values for X and Y coordinates can be from -16384 to 16383. 

BINARY ABSOLUTE FORMAT. Binary absolute data is plotted with 
respect to an origin at 0,0. Four bytes are required to specify a single end 
point. A 10 bit coordinate in the range 0-1023, is sent for both x and y. 

The bytes are ordered as follows: 


BIT 

7 

6 

5 

4 

3 

2 

1 


BYTE 1 

0 

1 

X9 

X8 

X7 

X6 

X5 

HI X 

BYTE 2 

0 

1 

X4 

X3 

X2 

XI 

XO 

LON X 

BYTE 3 

0 

1 

Y9 

Y8 

Y7 

Y6 

Y5 

HI Y 

BYTE 4 

0 

1 

Y4 

Y3 

Y2 

Y1 

Y0 

LON Y 


Although it is possible to send coordinates in the range 0 to 1023, only 
points in the range 0-511 for X, and 0-389 for Y are visible on the screen. 
Vectors going off the screen are clipped. If the data requires scaling, this 
must be done before the data is sent to the terminal. 

The following example shows how the 4 data bytes are computed. The 
numbers are converted to the 10 bit binary equivalent. Bits 7 and 6 are set 
to 01 to indicate a parameter. 


X = 0 ■ 00000 00000 Y ■ 0 00000 00000 


HI X 

LON X 


HI 

Y LON 

Y 

BYTE 

1 = 01 00000 

* 

SPACE 

HI X 


BYTE 

2 « 01 00000 

= 

SPACE 

LON X 


BYTE 

3 - 01 00000 

« 

SPACE 

HI Y 


BYTE 

4 = 01 00000 

= 

SPACE 

LON Y 


= 01011 01000 

Y 

« 180 

= 00101 

1 01 00 

HI 

X LON X 



HI Y 

LON Y 


BYTE 1 = 01 01011 - ♦ HI X 

BYTE 2 - 01 01000 = C LOW X 

BYTE 3= 01 00101 - % HI Y 

BYTE 4 = 01 10100 = 4 LON Y 


An escape sequence to draw a vector from 0,0 to 360,180 is as follows: 

♦ ( °/o 4 Z 

X=360/ Y*180/ 


Ec 


p i a SP SP SP SP 
X-0/ Y-0/ 
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Ec * p selects a plotting sequence. The "i" specifies absolute format. 
The "a" raises the pen up. The first 4 bytes (all spaces) move the raised 
pen to 0,0 where it is lowered. The next 4 bytes specify the point 360,180. 
After the 4th byte is received, the pen is moved to that point, drawing a 
vector. The upper case "Z" terminates the escape sequence. Note that if 
spaces are used in the data sequence they are interpreted as data and 
could result in an improper plot. 

BINARY SHORT INCREMENTAL FORMAT. The short incremental 
format uses two bytes to specify a delta X and a delta Y in the range -16 
to +15. The five least significant bits are interpreted as a signed, two's 
complement number. This number is added to the current pen position 
to obtain the new end point. The data bytes are ordered as follows: 

BIT 7 6 5 4 3 2 1 

BYTE 1 0 1 < DELTA X > 

BYTE 2 0 1 < DELTA Y > 


The following example illustrates the computation and use of the short 
incremental format: 

DELTA X = -12 = 10100 DELTA Y * 6 * 00110 
BYTE1 = 01 10100 = 4 DELTA X 
BYTE2 = 01 00110 * * DELTA Y 

The following sequence moves the pen to 360,180 in absolute format, 
then draws a vector to X = 360-12 = 348,y = 180 + 6 = 186. 

Ec * p i a + C 0/ 0 4 j 4 & <byte1><byte2>...Z 

BINARY INCREMENTAL FORMAT. Incremental is similar to short 
incremental, but with a larger range. Using six bytes, delta X and Y can 
range from -16384 to +16383. 


BIT 

7 6 

5 

4 

3 

2 

1 




BYTE1 

0 1 

DX1 4 

DX 1 3 

DX 1 2 

DX 1 1 

DX 1 0 

HI 

DELTA 

X 

BYTE2 

0 1 

DX9 

DX8 

DX7 

DX6 

DX5 

MID 

DELTA 

X 

BYTE3 

0 1 

DX4 

DX3 

DX2 

DX 1 

DX0 

LOW 

DELTA 

X 

BYTE4 

0 1 

DY1 4 

DY1 3 

DY1 2 

DY1 1 

DY1 0 

HI 

DELTA 

Y 

BYTE3 

0 1 

DY9 

DY8 

DY7 

DY6 

DY5 

MID 

DELTA 

Y 

BYTE2 

0 1 

DY4 

DY3 

DY2 

DY1 

DY0 

LOW 

DELTA 

Y 
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The following sequence moves the pen to 360,180 in absolute format, 
then draws a vector to X = 360-12 = 348,y = 180 + 6 = 186. 

Ec * p i a + ( 14 j 4 & <byte1><byte2>...Z 

The following example shows how incremental data bytes are generated. 


DELTA 

X = - 

400 = 11111 

1 001 1 

1 0000 



HI 

DX 

MID DX 

LO DX 

DELTA 

Y = 1 00 = 00000 

0001 1 

001 00 



HI 

DY 

MID DY 

LO DY 

BYTE 

1 = 01 

11111 = 

? 

HI 

DELTA X 

BYTE 

2=01 

10011 = 

3 

MID 

DELTA i 

BYTE 

3 = 01 

10000 = 

0 

LO 

DELTA X 

BYTE 

4 = 01 

00000 = 

spa 

ce HI 

DELTA Y 

BYTE 

5 = 01 

00011 = 

# 

MID 

DELTA 


BYTE 6 = 01 00100 * $ LO DELTA Y 


Table D-7. Characters Used in Packed Data Formats 


ASCI I 

Character 

Bit 

Pattern 

ASCI I 

Character 

Bit 

Pattern 

SP 

01 

0 

0000 

0 

01 

1 0000 

i 

01 

0 

0001 

1 

01 

1 0001 

•• 

01 

0 

0010 

2 

01 

1 0010 

# 

01 

0 

0011 

3 

01 

1 0011 

$ 

01 

0 

01 00 

4 

01 

1 0100 

0/0 

01 

0 

01 01 

5 

01 

1 0101 

A 

01 

0 

0110 

6 

01 

1 0110 

/ 

01 

0 

01 1 1 

7 

01 

1 0111 

c 

01 

0 

1000 

8 

01 

1 1000 

) 

01 

0 

1001 

9 

01 

1 1001 

« 

01 

0 

1010 


01 

1 1010 

♦ 

01 

0 

1011 

; 

01 

1 1011 


01 

0 

1100 

< 

01 

1 1100 

_ 

01 

0 

1 101 

« 

01 

1 1101 


01 

0 

1110 

> 

01 

1 1110 

/ 

01 

0 

1111 

9 

01 

1 1111 


BINARY RELOCATABLE FORMAT. Binary relocatable format 
specifies absolute X and Y coordinates in the range -16384 to +16383 
using 6 bytes. The value specified in the relocatable origin command is 
taken to be the 0,0 point. The actual screen address is computed by the 
terminal by adding the relocatable origin to the X,Y pair. 


BIT 

7 

6 

5 

4 

3 

2 

1 



BYTE 

1 

0 

1 

X 1 4 

X 1 3 

X 1 2 

XII 

X10 

HI 

X 

BYTE 

2 

0 

1 

X9 

X8 

X7 

X6 

X5 

MID 

X 

BYTE 

3 

0 

1 

X4 

X3 

X2 

XI 

XO 

LOW 

X 

BYTE 

4 

0 

1 

Y 1 4 

Y 1 3 

Y 1 2 

Y 1 1 

Y 1 0 

HI 

Y 

BYTE 

3 

0 

1 

Y9 

Y8 

Y7 

Y6 

Y5 

MID 

Y 

BYTE 

2 

0 

1 

Y 4 

Y3 

Y 2 

Y 1 

Y0 

LOW 

Y 
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The following example shows how relocatable data bytes are computed. 


RELOC X = - 

600 = 

11111 

HI X 

01101 01000 

MID X LOW X 

RELOC Y = 

200 = 

00000 

HI Y 

00110 01000 

MID Y LOW Y 

BYTE 1 * 01 

11111 

= 9 

HI X 

BYTE 2 = 01 

01101 

= - 

MID X 

BYTE 3 = 01 

01000 

= c 

LOW X 

BYTE 4=01 

00000 

II 

lil 

“O 

ace HI Y 

BYTE 5 = 01 

00110 

= & 

MID Y 

BYTE 6 = 01 

01000 

= c 

LOW Y 


Mixing Data Formats 

There are no restrictions on mixing data formats. Simply specify the new 
format to be used and follow it with data in the new format. Note that 
by restricting data values to binary values between 32 and 63, the 
printing graphics characters and numbers, the plotting commands "a -z" 
can be intermixed in the binary data. 

Example: Move the pen to 360,180 in ASCII absolute format, then draw 
a box 10 units wide by 5 units high using binary short incremental. 

Ec * p a f 360,180 j » SP SP % 6 SP SP ; Z 
1 2 3 4 5 



Figure D-12. Example of Mixed Data Formats 
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Table D-8. Absolute Format Addressing Bytes 



0 

1 

2 

3 

4 

5 

6 

7 

8 

9 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

350 

• > 

*7 


♦ 1 

... 

♦» 

♦ t 

♦X 

♦ 4 


0 

II 

1* 

! 

I" 

T 

1 • 

i 

it 

IX 

14 

i' 

i( 

l) 

360 

♦ < 

♦> 

. , 

♦ ♦ 

♦, 



. / 

♦0 

. i 

1 0 

I* 


1 , 

a 

i. 

1/ 

■ 0 

li 

12 

13 

370 

♦2 

♦3 

♦4 

♦5 

♦6 

♦ 7 

♦8 

♦9 



20 

14 

15 

16 

17 

18 

■ 9 

1: 

1; 

l< 

I* 

380 

♦ < 


♦ > 

» ? 

a 

t i 

, •• 

, 9 

t 

,x 

30 

l> 

I? 

•I 

i I 

i •• 

• • 

•t 

•X 

■4 

i ' 

390 

, 4 


,< 

, ) 

.• 

.* 





40 

•( 

! ) 


? *) 

i 

1 ' 

i 

\ / 

•0 

11 

400 

,0 


.2 

,3 

, 4 

,5 

,6 

, 7 

,8 

.9 

50 

! 2 

•3 

• 4 

•5 

•6 

•7 

•8 

•9 

1 : 

1 ; 

410 



, < 


, > 

, 9 

-a 

- i 


-1 

60 

• < 

• ■ 

• > 

i ? 

"I 

•• • 

"" 


"t 

"X 

420 

- $ 

-X 

l 

- ' 

-< 

- ) 

- • 




70 











430 



-0 

-1 

-2 

-3 

-4 

-5 

-6 

-7 

80 

"0 

"1 

"2 

M 3 

"4 

"5 

"6 

"7 

"8 

"9 

440 

-3 

-9 



- < 




. a 

• 1 

90 





M > 

••? 

/■ 

i ! 

i" 

II 

450 

.. 

. t 

. t 

.X 

. 4 

- 

.( 

. ) 

. 

. 

1 00 

it 

*X 

• 4 

i • 

li 

/) 

«. 

i * 

i , 

1 - 

460 




. / 

.0 

. 1 

.2 

.3 

. 4 

.5 

• 1 0 

i. 

i / 

#0 

1 1 

12 

• 3 

1 4 

1 5 

IS 

1 7 

470 

.6 

. 7 

.8 

.9 



. < 


. > 

. ? 

120 

iQ 

IS 

i : 

1 ; 

n 

!• 

l> 

n 

tl 

t • 

480 

■ 

/ • 


li 

It 

IX 

4 

/ • 

/( 

/ ) 

130 

$ M 

tl 

St 

tx 

t 4 

t ' 

t( 

t) 

t« 

t« 

490 

>* 


'• 

'• 

/. 

/ / 

/o 

n 

H 

/ 3 

1 40 

t , 

t- 

S . 

1/ 

to 

tl 

12 

S3 

t 4 

t5 

500 

/ 4 

/ 5 

/6 

/ 7 

1 8 

/9 

/ : 

/; 

/ < 

/. 

150 

*6 

$7 

18 

19 

t: 

t; 

t< 

t- 

t> 

• 7 

510 

/ > 

/ ? 

01 

0* 

0" 

0# 

0$ 

ox 

04 

0' 

160 

XI 

X! 

x" 

Xi 

Xt 

XX 

X 4 

X' 

XC 

X) 

520 

OC 

0) 

0* 

0* 

0, 

0- 

0. 

0/ 

00 

01 

170 

X• 

X* 

X , 

X- 

X. 

X/ 

xo 

XI 

X2 

13 

530 

02 

03 

04 

05 

06 

07 

08 

09 

0: 

0; 

180 

X4 

X5 

X6 

X 7 

X3 

X9 

X: 

X; 

X< 

X* 

540 

<■ 

0- 

0> 

0? 

11 

1 '■ 

1 M 

1 1 

1 t 

1 X 

190 

x> 

X? 

41 

4! 

4" 

4 • 

4 t 

4 X 

44 

4 ' 

550 

1 4 

, - 

1 < 

1 ) 

1 • 

1 ♦ 

1 , 

t . 

, . 

1 / 

200 

4 ( 

4) 

4 • 

4 ♦ 

4 , 

4- 

4 . 

4/ 

40 

41 

560 

1 0 

11 

1 2 

1 3 

1 4 

15 

16 

1 7 

18 

19 

210 

42 

43 

44 

45 

46 

47 

48 

49 

4 : 

4 ; 

570 

1 : 

1 ; 

1 < 


1 > 

1 ? 

21 

2! 

2“ 

2i 

220 

4 < 

4* 

4 > 

4" 

'1 

* i 

... 

' l 

't 

'X 

580 

2t 

21 

24 

2' 

2( 

2) 

2 • 

2 * 

2. 

2- 

230 

' 4 

' ' 

'( 

' ) 

' • 

' ♦ 

' , 

' - 

' . 

' / 

590 

2. 

2 > 

20 

21 

22 

23 

24 

25 

26 

27 

240 

'0 



'3 

' 4 

'5 

'6 

'7 

'8 

'9 

600 

28 

29 

2: 

2; 

2< 

2- 

2> 

2? 

31 

3' 

250 

' : 

' ; 

'< 


'> 

* 

(1 

( • 

(" 

a 

61 0 

3” 

3* 

31 

31 

34 

3' 

3C 

3) 

3» 

3» 

260 

<S 

(X 

(4 

( ' 

(( 

( ) 

( • 

<♦ 

( , 

<- 

620 

3, 

3- 

3. 

3/ 

30 

31 

32 

33 

34 

35 

270 

( . 

( / 

(0 

( 1 

(2 

(3 

(4 

(5 

(6 

(7 

630 

36 

37 

38 

39 

3: 

3; 

3< 

3- 

3> 

3? 

280 

(8 

(9 

( : 

( ; 

< < 

(• 

(> 


)l 

)! 

640 

41 

4 ' 

4" 

4# 

4$ 

41 

44 

4' 

4( 

4) 

290 

)’* 

)/ 

)$ 

)X 

>4 

)' 

)( 

)) 

)• 

)♦ 

650 

4 • 

4 ♦ 

4 , 

4- 

4 . 

4/ 

40 

41 

42 

43 

300 

) , 

)- 

). 

)/ 

>0 

)1 

>2 

) 3 

) 4 

)5 

660 

44 

45 

46 

47 

48 

49 

4 : 

4 ; 

4 < 

4- 

310 

)6 

)7 

)8 

)9 

): 

); 

X 

>• 

)> 

)? 

670 

4 > 

4? 

51 

S' 

5" 

5 • 

5* 

5X 

54 

5' 

320 

•1 

• i 


• i 

• t 

•X 

•4 

♦ ' 

•( 

•) 

680 

5( 

5) 

5» 

5 ♦ 

5, 

5- 

5. 

5/ 

50 

51 

330 

• « 

• ♦ 

• , 

* - 

• . 

• / 

•0 

tl 

• 2 

•3 

690 

52 

53 

54 

55 

56 

57 

58 

59 

5: 

5; 

340 

• 4 

•5 

•6 

• 7 

•8 

•9 

* : 

* 1 

• < 

* “ 

700 

5< 

5- 

5> 

5“> 

61 

6' 

6" 

6# 

64 

6X 

Note 

: 1 

indicates a 

"space" 

character; every 

710 

64 

6' 

6( 

6) 

6* 

6* 

6, 

6- 

6. 

6/ 


coordinate 
two charac 

address 
ters sho 

must consist of 
wn in the table. 

the 


Table D-9. Incremental (short) Vector Bytes 


0 1 

2 

3 

4 

5 

6 

7 

8 

9 

10 11 

1 2 

1 3 

1 4 

15 

l 

" 

i 

$ 

X 

& 

' 

( 

) 

* ♦ 

• 

- 


/ 

-16 -15 

- 1 4 

-13 

-12 

-1 1 

-10 

-9 

-8 

-7 

-6 -5 

-4 

-3 

-2 

-1 

0 1 

2 

3 

4 

5 

6 

7 

8 

9 

: * 

< 

* 

> 

? 


Graphics Functions In Display 
Functions Mode 

The DISPLAY FUNCTNS key (at the MODES level) can be used to display 
the graphics escape sequences or the action of graphics control keys. The 
control sequences are entered into the alphanumeric display each time a 
command is executed. Table D-10 lists the graphics control sequences that 
are generated when DISPLAY FUNCTIONS is on. 
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Table D-10. Graphics Control Sequences Used in Record Operations 


Key 

Sequence 

Description 


none 

Graphics cursor controls 

Cursor fast 

none 

Graphics cursor fast 

Graph cursor 

Ec * dK 

on 


Ec * dL 

off 

Graph display 

Ec * dC 

on 


Ec * dD 

off 

Graph clear 

Ec * dA 


Alpha display 

Ec * dE 

on 


Ec * dF 

off 


Figure D-13 shows the sequences generated when drawing a simple box. 
The graphics cursor is initially on and positioned at 0,0. 


0*t*p*213,213Z 
© S:*pa213,213,382,213Z 
© *c*pa382,213 382,109Z 
0^*382,109 213,109Z 
0 *P*213,109 213,213Z 


213,213 382,213 


OO 

o 


o 

o 


213,109 382,109 


+ 


0,0 


Figure D-13. Displaying Graphics Sequences 
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Graphics Hardcopy Operations 

There are two methods of obtaining a hardcopy of the contents of graphics 
memory. One method uses the function keys and graphics keys on the 
keyboard. The other method uses escape sequences which may be coded 
into a program running on a host computer. The hardcopy may be output 
from the original internal printer, or from an external printer capable of 
interpreting raster escape sequences connected to the external printer port 
at the rear of the terminal. 

When the optional internal printer is selected as the output device, a dot- 
by-dot transfer of the graphics memory is made on thermal paper. The 
image is 14.5 cm by 11 cm (5.75 by 4.25 inches) centered on the paper. The 
transfer takes approximately 30 seconds. 

The external printers that can be used for graphics hardcopy are the HP 
2671G, HP 2673A, HP 2932A, HP 82906A, and HP 2934A. 
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Initiating A Transfer From The Keyboard 

The Graph copy key on the graphics /numeric pad initiates the graphics 
transfer. The keyboard must be in graphics mode for the Graph copy 
function to be performed. Pressing I control I, and the GD key on your 
graphics keypad toggles the function of the keypad between graphics 
mode and numeric mode. Pressing the Graph copy key generates an 
error message if no valid destination device has been specified. 

The destination(s) may be selected by pressing I user System l device 
control , and to devices. You may then select SERI AL DEV I CE , 
INTERNAL PRINTER and/or HP-IB DEVICE. TO SERIAL DEVICE selects 
the external printer port, and TO INTERNALPRINTER selects the optional 
internal printer. HP-IBDEVICE selects an external printer on the HP-IB 
interface. 

Using The Ec & p Escape Sequences 

Coding a program to transfer graphics data either to the internal printer 
or to the external printer, or both, requires selecting the graphics 
memory as the source of either or both printers as the destination. 

graphics memory as the source: 7 5 

internal printer as the destination: 6d 
external printer as the destination: 4d 
alternate printer as the destination: 5d 

Example : Define graphics memory as source and internal printer as 
destination. 

Ec & p 7s 6D 

Example: Define graphics memory as source and both printers as 
destination. 

Ec & p 7s 4d 6D 

After the source and destination are defined, the transfer is initiated by 
either: 

Ec & p F (copy file from source to destination) 

or 

Ec & p M (copy all from source to destination) 

Note that an escape sequence is terminated with an uppercase character. 
Also, you may combine the source and destination assignments and the 
transfer initiation in one escape sequence: 

Ec & p 7s 4d F 
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NOTE 

The escape sequence (Ec & p 5 d) assigns the alternate printer as the 
destination for graphics data transfer. It also gives the host system 
control of the setting until the terminal receives the sequence Ec & p 3 D 
from the host computer or a HARD RESET from the keyboard or host. 
You should code the sequence Ec & p 3 D after graphics transfer is 
complete. This prevents the display of an I/O error message on the 
terminal screen when the keyboard operator tries to select \TO SERIAL 
DEVICE\ on the terminal configuration menu. 


Graphics Text 

Text strings can be written directly into the graphics image memory. An 
internal character generator converts the ASCII codes into a dot matrix 
representation which is drawn as vectors. The character set includes 
upper and lower case (95 characters) and the national characters. The 
characters will be drawn as a 5 by 7 matrix in a 7 by 10 cell, with 
descenders for lower case. This character set is in addition to the 
normal alphanumeric character set. While this character set may seem 
redundant, it offers the following advantages: 

• Characters can be drawn at any dot position, rathen than 24 by 80 
alphanumeric character positions. 

• Characters can be rotated in multiples of 90 degrees. 

• Characters can be scaled in size, from 1 to 8 times. 

• Characters can be slanted 45 degrees for an italics-like effect. 

• Lines of characters can be right, left, or center justified. 
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Figure D-14 shows the graphics character set. 


abcdef ghi i j k 1 mnopq r s tuvwx y z 


A B C D E F C H I J K L M N 0 P Q R S T U V I.J X V Z 



Foreign 

Characters 


NOTE: All of the U.S. ASCII and foreign characters are accessible by entering "YES” in the ASCII 8 Bits 
config field o f the Terminal Configuration menu; then entering foreign charact er m ode set by 
typing , O . You may shift back to the Roman base set by typing QQ . 


Figure D-14. Graphics Text Characters 


Keyboard Control Of Graphics Text 

Graphics text can be entered directly from the keyboard. The backspace, 
carriage return, and line feed functions work as expected (even on 
inverted text), making it easy to add or edit titles and labels. A summary 
of escape sequences and keyboard operations affecting Graphics Text 
Mode is given Table D-ll. 


NOTE 

Use of keyboard functions may result in graphics text being overlaid. 
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Table D-ll. Graphics Text Functions 


Key 

Description 

Ec « d S 

Selects the graphics image memory as the destination for all 
text. Characters entering from the keyboard or datacomm, 
are drawn as vectors in the graphics memory using the cur¬ 
rent text size and angle (see below). The graphics cursor indi¬ 
cates the position of the next character. Moving the graphics 
cursor will cause the next text line to begin at the new cursor 
position. The carriage return, line feed, and backspace func¬ 
tions work normally. 

Ec * d T 

Terminates Text Mode. 

Ec « m 

<5ize > M 

Increases the character size from 1 to 8X. The smallest charac¬ 
ter is a 5 by 7 matrix in a 7 by 10 cell. Increasing the size 
makes the dots bigger while the character is still drawn as a 5 
by 7 matrix. 

Ec ♦ m 

<orienta- 

t i on > N 

Sets the character orientation (multiples of 90 degrees). 

Ec * 0 

Ec * P 

Turns slant on or off. 

ns 

Spaces one graphics text character to left. 

Spaces one graphics text character to right. 

m re 

(Vertical Tab). Spaces one graphics text line up. (The actual 
direction of movement will depend on the text orientation.) 


The following keys function in the same manner as for alphanumeric 
text: 

[RETURN L [~CTRL"| ID, B, B, Q], □ 
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Program Control Of Graphics Text 

All of the parameters for graphics text can be set programmatically. 
Commands are of the form: Ec * m <parameter> <command >. The 
command can be alone or part of another Ec * m sequence. 

SIZE. The ASCII characters 1 through 8 specify the character size for 
graphics text (see Figure D-15). A "1" indicates the smallest character, a 5 
by 7 dot matrix in a 7 by 10 cell. Increasing the size increases the size of 
the characters. 

Set Graphics 

Text Size: Ec * m <size> m 

TEXT DIRECTION. This command uses the ASCII characters 1 through 
4 to specify the text orientation (see Figure D-16). This also changes \ 
the direction of line feed, carriage return, and backspace. 

1 — Normal (upright, the default) 

2 — Rotated 90 degrees counter clockwise 

3 — Rotated 180 degrees counter clockwise (inverted) 

4 — Rotated 270 degrees counter clockwise 

Set Graphics 

Text Orientation: Ec * m <orientation> n 


Text Size Normal Slanted 



Figure D-15. Grapics Text Sizes 
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I 


>_> 

uJ 

tiT 


'*4 

as 

Cj 


5 


TEXT DIRECTION 


NOI103*10 1X31 


A V 7J v‘7 'S&/& J ji 


TEXT DJSi 


7ICW 


n 


y. 


Figure D-16. Graphics Text Directions 

SLANT. The graphics text characters can be slanted 45 degrees for an 
italics effect. 

Turn On Graphics 
Text Slant: Ec * m o 

Turn Off Graphics 
Text Slant: Ec * m p 

JUSTIFICATION/ORIGIN. Text strings can be automatically right or 
left justified, or centered about a specified point. An ASCII character 0 
through 9 indicates the origin (justification and base line) for characters 
with respect to the current pen postition. This function is useful when 
drawing labels. (Refer to the Label command.) 

Set Graphics 

Text Justification: Ec * m <origin> q 

If text is left justified, the current pen position is the left margin. Center 
causes the label to be centerd on the pen position. Right justify selects 
the pen position as the right margin. Bottom, middle, and top select the 
base line for the line of text. 
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Left 


Center 


Right 



The numbers 1-9 represent the cursor position with respect 
to the character cell used for graphics text characters. 


Figure D-17. Graphics Text Cursor Position 

For example, if text was to be right justified and set with a base line on 
top of the normal character position, the number "9" would be used. 
Figure D-16 illustrates the various text positions. 

When centering or right justification is used, the text strings are buffered 
(stored) until all of the characters in the string have been received. The 
string end is detected by a CR or LF. The string is not displayed until the 
CR or LF is received. This may be confusing when entering text from the 
keyboard. The maximum length of a string when center or right 
justifying is 73 characters (not including the CR(LF)). In all cases, data 
written beyond the edge of the screen is lost. There is no automatic 
RETURN when the screen boundary is reached. 

TURNING GRAPHICS TEXT ON AND OFF. Graphics text mode can 
be turned on or off from a program. These two commands use the 
E c * d sequence but are discussed here under graphics text for 
completeness. 

On. This command will cause Graphics Text Mode to be turned on. All 
displayable characters will be stored in the graphics memory. The 
current drawing mode remains in effect until a command is issued to 
change modes. 

Text is drawn using the current text assignments for size and orientation. 
Graphics text mode accepts CR, LF, BS, HT, and VT as control characters. 
The ■*, *, t-, 4 keys can be used to position the graphics cursor in 
character increments. 
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Turn On Graphics 
Text Mode: E c * d 5 

Turn Off Graphics 
Text Mode: E c * d t 

If the graphics cursor is moved, the graphics text margin is moved to the 
new cursor or pen position. 

Characters are drawn using the current drawing mode (set, clear, or jam). 
Entering a character, backspacing, and entering a second character causes 
an overstrike. 

If a lower case "s" is used, additional escape parameters can be appended 
to the sequence. Otherwise the next characters will be routed to the 
graphics memory. 

Examp 1es: 

Ec * d 5 k 1 00 , 1 00 o B 

Ec * d S This is a text string 

Off. This sequence turns off graphics text mode and restores normal 
alphanumeric operation. 

Turn Off Graphics 
Text Mode: Ec * d t 

Note that the 1 enter | key and modify mode do not work on text in 
graphics mode. 

GRAPHICS TEXT STATUS. You can check the current text settings 
with a graphics text status request. Refer to the Status section in this 
chapter for additional information. 

LABEL. This sequence is used to send a single record of graphics text to 
the terminal. The characters are stored in the graphics memory using the 
current text size, angle, slant, and justification. The label is drawn 
beginning at the current pen position. 

Graphics 

Text Label: Ec * 1 <text string> <CR> <LF> 

The record must end with a CR, LF, or both. A CR moves the pen to its 
original position when the label command was the first received. An LF 
moves the pen down one line (character spacing). Note that the actual 
directions moved following a CR or LF depend on the text orientation 
selected. 

The maximum record length is 73 characters, not including the Ec * 1 
preamble or the <CR> <LF> 

Example: Ec * 1 This is a sample label<CR> <LF> 
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Compatibility Mode 


Compatibility Mode allows the terminal to plot data intended for a 
terminal using a display with 1024 by 1024 addressable points or 4096 by 
4096 (4014 emulation). This mode makes it possible to use graphics 
programs developed for use with other graphics terminals with a 
minimum of reprogramming. 


The terminal operates in two submodes while in Compatibility Mode. In 
Alphanumeric mode the terminal simply displays alphanumeric data on 
the screen as in normal operation. In Graphics mode the terminal 
responds to alphanumeric data as vector coordinates. Normally the 
terminal will be switched between these modes to display messages, plot 
graphics figures, and then display additional messages. These modes are 
controlled with several control sequences. (These sequences are ignored or 
acted on differently if the terminal is not set for Compatibility Mode.) 
Table D-12 lists the terminal's responses to Compatibility Mode control 
sequences. 


If delays are required, the baud rate can be lowered or fill characters added 
to prevent data loss when operating the terminal at high speeds. 

Vectors are drawn using the current line type, color pen, and line drawing 
mode. This gives you the capability of drawing dotted and dashed lines, 
etc. by changing the program to send the additional escape sequences. 
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Table D-12. Compatibility Mode Control Sequences 


CONTROL 

SEQUENCE 

DESCRIPTION 

RESPONSE 


Read status and alpha cursor position 

Otatus byte> <HI X> <L0 X> 

<HI Y> <L0Y> <terminator> 


10 11/0 0/1 0/1 0/1 1 

L.—- Auxiliary Device (inactive) 


Margin 
0 = margin 1 
1 = margin 2 

Mode 

1 0 = Graphics Mode 
0 1 = Alpha Mode 
The terminal will return one of the following characters as the status byte: 

|-No printer or printer not ready 

; — Margin 2, Graphics Mode 

9 — Margin 1, Graphics Mode 
7 — Margin 2, Alpha Mode 
5 — Margin 1, Alpha Mode 


(20 ms delay) 

Read graphics cursor position 

<H I X> <LQX> <H I Y > <LQ Y > <terminator> 



<KEY> <H 1 X> <L0X> <HI Y> <L0Y> 


Read graphics cursor position when key struck 

< terminator > 


Make hardcopy 


'c'f 

End graphics mode, clear screen, and home cursor 


% 

Go into graphics mode (draw vectors) 


4s 

Go into alpha mode 


% 

Backspace (H) Moves 1 space left (14 units) 


"r 

Horizontal Tab (1) Moves 1 space right (14 units) 


4, 

End graphics mode 


l f 

Line Feed (J) Moves 1 line down (22 units) 


4- 

Vertical Tab (K ) Moves 1 line up (22 units) 



NOTES 


The terminal will normally respond with an V character when an S character is received Compatibility Mode disables the terminal's S/V handshake. 
Compatibility Mode causes most control codes to be ignored. 

The Read Status, alpha cursor position, and graphic cursor position cause block transfers to the computer system. If the computer system does not 
use the DC 1 /DC2/DC1 handshake, InhHndShk CG)and InhDC2 CH) in the Terminal Configuration menu must be "YES "for these transfers 
to occur (Refer to "Terminal Configuration Menu" in Section II). 


Depends on parity 

Hard Copy Unit 
1 = not ready 
0 = ready 
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Compatibility Mode Configuration 

The five operating states for Compatibility Mode — OFF, UNSCALED, 
SCALED, SCL 4014, and UNSC 4014 — appear in the GraphCompat field 
in the Terminal Configuration menu. The default state is OFF. This field 
can be set programmatically using the "Ec & s" and "Ec » t" sequences 
shown in Table D-13. The P and Q straps and the Graph Compat 
parameter in the terminal configuration menu determine the terminal's 
mode of operation after being initialized (power up or hard reset). The 
straps are interpreted as follows: 


Table D-13. Commands for Selecting Compatibility Mode 


Ec & 5 < x > p 

Ec & 5 <y >q 

Ec * t < z >d 

Graph Compat 

0 

0 

- 

OFF 

0 

1 

0 

UNSCALED 

0 

1 

1 

UNS 4014 

1 

0 

0 

SCALED 

1 

0 

1 

SCL 4014 

1 

1 

- 

OFF 


Table D-13 lists the escape sequences that set and clear the P and Q 
straps, and the graphics compatibility parameters in the terminal 
configuration menu. In addition, when in Compatibility Mode, you can 
select the following optional capabilities: 

GRAPHIC INPUT TERMINATOR. You can select the terminator sent 
by the terminal following the input of cursor address information. The 
terminator can be CR, CR and EOT, or no terminator. 

PAGE FULL BUSY. When this strap is in, the keyboard will be locked 
after the 35th line of text is received from the computer. The terminal 
can be cleared by pressing the Graph clear key. This strap is ignored in 
Unsealed Mode. 

PAGE FULL BREAK. When this strap is in, the terminal will send a 
200ms break signal to the computer after the 35th line of text is 
displayed. The terminal may also be set to BUSY (see Page Full Busy). 
When out, the strap will cause the cursor to home and the next 35 lines 
of text to be set with a left margin at x=259. This strap is ignored in 
Unsealed Mode. The commands to control these strap options are listed 
in Table D-13, above. 
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Graphics Data 

4010 EMULATION. The terminal normally allows you to address 512 X 
390 points; in Compatibility Mode, the number of addressable points 
extends to 1024 X 780, emulating the 4010. Line length in normal 
operations is 24 lines by 80 characters; while in Compatibility Mode, line 
length is 35 lines by 74 characters (see Figure D-18). 4010-style graphics 
can be drawn either scaled or unsealed. Scaling divides X and Y 
coordinates by 2, mapping the 1024 X 780 display into 512 by 390. This 
allows a program written for the 1024 X 780 terminal to run unchanged, 
and still display the entire picture, with some loss in resolution (see 
Figure D-19). 

Unsealed mode displays a 512 by 390 subset of the 1024 X 780 picture. 
The area this covers can be changed by modifying the value of the 
relocatable origin (and redrawing the picture). The relocatable origin is 
subtracted from all incoming coordinates in unsealed mode. If this is set 
to 0,0 (the default) the range X = 0 to 511, Y = 0 to 389 is displayed (see 
Figure D-18a. 

Setting the origin to 0,360 would cover the X = 0 to 511, Y = 360 to 749. 
To display an area larger than 512 X 390, you must change the scaling 
statements in the program. 


A.) Tektronix 4010 B.) HP Terminal 


(0,779) 

1 ; 

(1023,779) 

(0,389) 

1 ; 


'.■M — 74 Characters — 



-80 Characters— 

(0,0) 

35 

(1023,0) 

(0,0) 

24 


798,720 Points 199,680 Points 

2590 Characters 2847 Characters 


Figure D-18. Comparison of the 4010 and the HP Terminal 

Graphics Data Format 

In Compatibility mode the graphics data is formatted as two-byte 
coordinate values. The lower five bits of each byte are used to make a 10 
bit (0-1023) coordinate. Data sent to the terminal must have the "Y" 
coordinate sent first; < Upper Y> <Lower Y> <Upper X> <Lower X>. 

When data is returned to the computer (cursor position, etc.), the X 
coordinate is returned first; <Upper X> <Lower X> <Upper Y> <Lower 
Y>. 
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Data bytes sent to the terminal use bits 6 and 7 to indicate the byte is an 
Upper byte, a lower Y, or a lower X. Bit 8 (parity) is not used. 

Bits 
7 6 

0 1 Upper X or Y byte 

1 0 Lower X byte 

1 1 Lower Y byte 

These identifying bits allow you to send only the changed portion of a 
four byte address. The following data bytes must always be sent: 

• Lower X byte 

• Any changed byte 

• Lower Y byte if the Upper X byte has changed 

Table D-14 at the end of this section can be used to determine address 
bytes. For example, to plot the points A (0,0), B (0,31), C (256,31), D (256,0) 
the sequence shown in figure D-21 is used: 



39 

Lines 


Scaled Mode 

1024 x 780 Image Area 

(Text Size and Slant 

are disabled in Scaled Mode) 


Display Comparison HP Terminal Display in Scaled Mode 

Figure D-19. Scaled Data 
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779 


390 


0 


HP Terminal 
512 x 390 Subset 

Relocatable 

Origin: 

ESC*m,0,390 


0 511 1023 


779 


389 


0 


1024 x 780 Image Area 


512 x 390 Subset 

Relocatable 

Origin: 

ESC*m0,0J 


0 511 1024 



HP Terminal 

512 x 390 Subset 

779 



Relocatable 

Origin: 

ESC*m 512.390J 

389 




T HP Terminal 
| 512 x 390 Subset 



0 

1 Relocatable 
* Origin: 

| ESC*m512,0J 


_J- 0 - 1 --- 

512 1023 0 512 1023 


Changing the Relocatable Origin (ESC *m x,y J) on HP Terminal’s Display 
to Cover the Entire 1024 x 780 Display in Unsealed 

Figure D-20. Unsealed Data 


Text 

When text is written to the graphics memory, the graphics cursor is 
moved to indicate where the next character will be stored. This differs 
from terminals that have only one mode for text and display the 
graphics cursor only when waiting for graphic input from the user. 

SCALED MODE GRAPHICS TEXT. In Scaled Mode, text is initially 
written into the graphics memory. The size is fixed to allow for 35 lines 
of text. The text angle is set at 0 degrees and unslanted. The text origin is 
£et to the left and bottom. These settings allow the "Page Full" feature to 
work properly and existing software to run without changes. If you do 
not require the Page Full feature, you can not change the text settings. 
You can redirect the text to the alphanumeric memory. 

UNSCALED MODE GRAPHICS TEXT. In Unsealed Mode, the text size 
is unchanged and graphics text mode is not initially turned on. Text is 
stored in the alphanumeric memory unless the graphics text mode is 
specifically enabled. 
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Normal Addressing: 
Short Addressing: 

Note: "SP” means 
"space” character 


Y = 0 X = 0 Y = 31 X = 256 Y = 0 X = 0 


A B C D A 

^ SP ' SP 9 SP ■ SP $ SP ■ ( 9 SP ' ( G SP ' SP® 

^ SP ' SP ® ■ ® ■ ( ® ' ® 'SPG 


Turn on Return to 

graphics mode alphanumeric mode 


0,31 



Figure D-21. Determining Address Bytes 


4014 Emulation 

In 4014 Mode the terminal emulates the functions of a Tektronix 4014 
terminal equipped with the Enhanced Graphics Module option. 4014 
Mode adds the following features to the terminal. Refer to the manual 
for the Tektronix 4014 for additional information on the 4014 operations. 

SCALED 4014 MODE (SCL 4014). In 4014 mode the screen resolution is 
extended to 4096 by 4096 addressable points (4096 X 3120 displayable). 
Two binary bits of precision are added to the address space. Points are 
addressed as 0.25, 0.5, 0.75, 1.0, etc. The two binary bits are specified by 
an "extra byte," allowing 4010 graphics, which use only the integer 
addresses of the 4014, to appear fulhsized on the 4014-mode display. The 
address space is divided by 8 to fit the entire picture on the 512 by 390 
screen. Graphics drawn in this mode have the same appearance on the 
screen as graphics drawn in scaled mode. 
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Patterned Vectors. Whereas the 4010 draws only solid vectors, the 4014 
has five line types — solid, dotted, short-dash, long-dash, and dot-dash. 
Escape sequences for these line types are accepted in SCL 4014 mode. 
These sequences retain their HP functional definitions in SCALED 
(4010) mode. The following commands select the line type for vector 


drawing: 


Ec ' 

for normal vectors or alphanumeric data 

Ec a 

for dotted line vectors 

Ec b 

for dot-dashed vectors 

Ec c 

for short-dashed vectors 

Ec d 

for long-dashed vectors 


The sequences Ec <h through 1> and Ec <p through t> can also be 
used to select line types. The terminal accepts the line type specified by 
the sequence but ignores the 4014 line-width definition (defocused and 
write-thru vectors are not supported on the HP terminal). 

Variable Character Sizes. The terminal ignores 4014 commands for 
changing character size. Thus the sequences Ec8,Ec9,Ec : and Ec ; 
are not executed in 4014 Mode. 

UNSCALED 4014 (UNS 4014). The same vector-drawing capabilities 
available in Scaled 4014 mode apply in this mode, but no scaling is 
performed. The 512 by 390 screen displays a window on the 4096 by 3120 
surface (the window is 1/64 the total image). As in unsealed mode, the 
relocatable origin is used to specify the window's lower left corner. 
Alphanumeric characters are directed to alpha memory, as they are in 
unsealed mode. 

INCREMENTAL POINT PLOT. Sending the terminal an RS control 
character sets incremental point plot operation. Commands for pen up 
(SP)(i.e., an ASCII "SPACE") or pen down (P) control vector drawing in 
this mode. The terminal draws a single dot as the graphics beam moves 
in one-point increments to the following directional commands: D - 
North; E - Northeast; A - East; I - Southeast; H - South; J - Southwest; B - 
West; F - Northwest. 

POINT PLOT. An FS control code selects point plot mode operation. As 
HP 4010 line type 11, only the last point of a vector is drawn. 

SPECIAL POINT PLOT MODE. The terminal displays vectors drawn 
in this mode, but does not vary the intensity of the graphics beam. 
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Programming Considerations 

When SCALED or SCL 4014 mode is selected via the Terminal 
Configuration menu, applying power to the terminal or executing a hard 
reset turns on the graphics cursor and positions it in the upper left-hand 
corner of the screen display, emulating the 4014 function. When 4014 
mode is selected programmatically, the state of the cursor and pen is not 
changed. 

When the Global Configuration Menu POWER ON parameter is set to 
COMPUTER, P.A.M. resets SCALE/SCALE 40 14 to OFF in the Terminal 
Configuration Menu. 

8-BIT MODE. Characters sent to the terminal in 4014 mode have their 
parity bit cleared automatically. Thus the ROMAN extension character 
set is not accessible in 8-Bit and Tektronix-modes. 7-bit mute processing 
retains its normal function. 





Table D-14. Coding of Compatibility Mode Graphics Data 
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Table D-14. Coding of Compatibility Mode Graphics Data 
(Continued) 
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Example: 340Y.70X is found as follows: 

340Y = 42 (upper Y) 116 (Lower Y) 70X = 34 (Upper X) 70 (Lower X) 
















Graphics Status 

You can request graphics status information in addition to normal 
terminal status data. All graphics status requests are initiated by sending 
an Ec * 5 followed by a single parameter (1 through 12) and terminated 
by a caret ( A ). The single parameter selects the desired status block. If an 
invalid parameter is used, the terminal responds with its ID (see Device ID 
Request, parameter =1). 

Graphics Status request: Ec * 5 <parameter> A 

where E c * 5 is the graphics status escape sequence. 

<parameter > is 1-12 and selects one of twelve blocks of graphics status 
data. 

The graphics status blocks that can be requested are listed in Table D-15 
together with the format of their terminal's response. Detailed 
descriptions of each status request are found in the following paragraphs. 

The terminal responds with one or more bytes of status information 
followed by a block terminator. All status information is in ASCII format, 
with commas as separators. Coordinates are returned in a fixed format 
consisting of a sign and five digits. Leading zeros are used as required to 
provide a fixed number of digits (ie +00100, -01234). This allows you to 
use simple input statements without needing to mask or shift bits. 

If DC1 handshake protocol is enabled (ie, "NO" is entered in the 
"InhHndShk(G)" and "InhDC2CH>" fields of the Terminal Configuration 
menu), the status block is not actually sent until receipt of a DC1 character. 
If the DC1 character is used, only one graphics status request can be 
enabled while the terminal is waiting for a DC1. When the DC1 is 
received, the last graphics status block requested is sent to the terminal. 

While the terminal is waiting for the DC1, the Device Status Pending bit 
is set. 

The terminal's configuration defines the terminating character sent 
following the status block (CR, CR-LF, or RS). Graphics status requests 
turn on an echo suppress mode in the terminal (only if the graphics 
option is installed). This prevents information echoed back from the 
computer from being displayed on the screen. Once a graphics status 
block has been sent, characters received by the terminal are not displayed 
until one of the following control characters is received: BELL, BS, CR, 

EC , GS , HT, LF , RS , US , VT. With the exception of CR and LF, the 
terminating control code itself is executed. 
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The terminal expects the status information to be echoed and uses the 
terminating control character to turn off the suppress echo mode. If the 
computer does not echo the status, a suitable control character must be 
returned to the terminal to turn off echo suppression. 

The graphics status blocks are shown in Table D-15. 


Table D-15. Graphics Status Requests 


Parameter 

Request 

Response 

1 

Read device I.D. 

2623A OR 150A 

2 

Read current pen position 

<X> , <Y>,<PEN> 

3 

Read graphics cursor position 

<X>,<Y> 

4 

Read graphics cursor position with wait 

<X> ,<Y> ,<KEY> 

5 

Read display size 

<LLX> ,<LLY>,<URX>,<URY>,<MMX>,<MMY> 

6 

Read device capabilities 

<b1>,<b2>,. . . <b15> ,<b16> 

7 

Read graphics text status 

<X size>,<Ysize>,<origin>,<angle>,<slant> 

8 

Read zoom status 

001 . ,0 

9 

Read relocatable origin 

<X>,<Y> 

10 

Read Reset status 

<RESET>,<b1> . . . <b6>,<b7> 

11 

Read area shading capability 

1 ,8,8 

12 

Read dynamics capability 

1 .1 


Read Device ID (Parameter=1) 

When you request a device ID the terminal responds with its generic 
Hewlett Packard model number, 2623A or 150A. 

Device ID Request: Ec * 5 1 A 

The terminal responds: 2623A <terminator> 

or 

150A <terminator> 


Read Current Pen Position (Parameter=2) 

The pen position and status are returned as a string of ASCII characters. 

Pen Position Request: Ec * s 2 A 

Where < X > = X coordinate 

<Y> = Y coordinate 

<Pen> = Pen state, 0 = pen up, 1 = pen down 

For example, assume that the pen is at 360,80, the pen is up, and the 
terminal is set for the DC1 handshake, with CR as the terminator: 
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The computer sends: Ec * 5 2 ^DCI 

X coordinate Pen state 
The terminal responds: +00360, +00080, OCR 

Y coordinate 

Read Graphics Cursor Position (Parameter = 3) 

The graphics cursor position is returned as a string of ASCII characters. 

Read Graphics Cursor Request: Ec * 5 3 A 

The terminal responds: < X > = X coordinate 

<Y> = Y coordinate 

When the cursor is positioned in the lower left corner of the screen, the 
terminal's response is: 

+ 00000 , +00000 CR 

Read Cursor Position With Wait (Parameter=4) 

This request allows the user to position the cursor, then strike the key to 
return the position. The ASCII decimal code for the key stroke is also 
returned (not the actual character). The code is returned as three digits. 
For example, striking an uppercase A returns 065, the ASCII decimal 
code for an uppercase A. Only ASCII character keys generate a response 
(ie, ROLL UP, ROLL DOWN, etc., are ignored). The graphics cursor is 
turned on if it is not already on. If an escape sequence is received by the 
terminal after it has received the READ CURSOR with WAIT command 
and before a key is struck, the READ CURSOR command is aborted. The 
new sequence is executed instead. 

Read Graphics Cursor with Wait Request: Ec # 5 4 A 

The terminal responds: <X>,<Y>,<keycode> <terminator> 

where < X > = X coordinate 

<Y> = Y coordinate 

< k ey code> = Decimal value of key struck 

For example, if you position the cursor at the lower left corner of the 
screen then press the "A" key, the terminal responds: 

+00000, +00000, 065 CR 

The position bytes are ordered as in the read pen request (Parameter 2). 
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Read Display Size (Parameter=5) 

This request returns the number of displayable units in the X and Y axes. 
It also returns the number of units per millimeter in the display. This 
request allows you to scale data for use on graphics devices with varying 
display area sizes. 

Read Display Size Request: Ec * 5 5 A 
The terminal 

responds: <LLX>,<LLY>,<URX>,<URY>,<MMX>,<MMY><terminator> 

Where: <LLX>,<URX> = Lower left and upper right X coordinates 
<LLV> , <URY> = Lower left and upper right Y coordinates 
<MMX> , <MMY > = Number of units per millimeter in the X and 
Y axes (five digits and a decimal point) 

The terminal always returns a fixed response. The lower left corner has 
coordinates of 0,0. The upper right corner has coordinates of 511,389. 
There are approximately 2 units per millimeter in each axis. 

Terminal response: +00000 , +00000 , +0051 1, +00389, 00003., 
00003.<terminator> 

Read Device Capabilities (Parameter=6) 

The device capabilities request returns a list of graphics plotting features 
available in the terminal. This allows you to use one program for a 
variety of graphics devices. Not all the features listed are available in the 
terminal. The absence of a feature is indicated by a zero (0). If a feature is 
present, it may be necessary to send an additional request to determine 
the exact capabilities present. Where multiple response values are 
possible, the terminal's standard response is enclosed in triple stars. 

Drive Capability Request: Ec * s6 A 
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The terminal responds: 

<b1>,<b2>,<b3>,<b4>, . . . <b16xterminator> 

where: < b 1 > = Clear display 

0 = no clear 

1 = paper advance 

2 = clear (total erase) 

3 = partial clear by area 

<b2> = Number of Pens (1) 

<b3> = Color Capability 

0 = black or white 
1 = gray levels 

<b4> = Color Level Capability (0) 

" 0 " means no color 
< b 5 > = Area Shading 
0 = no 

1 = yes (see Read Area Shading Capability) 

<b6> , <b7> = Not used (0,0) 

<b8> = Dynamic Modification 
0 = no 

1 = (see Read Modification Capability) 
<b9> = Graphic Character Size 
0 = fixed 

1 = Integer multiples of the basic cell size 

< b 1 0 > = Graphics Character Angles 

0 = fixed 

1 = Multiples of 90 degrees 

2 = multiples of 45 degrees 

3 = any angle 

< b 11 > = Graphics Character Slant 

0 = fixed 

1 = 45 degrees 

2 = any angle 

< b 12 > = Dot-Dash Line Patterns 

0 = none 

1 = predefined only 

2 = user-defined and predefined 

<b13>-<b16> = Not Used (0,0,0,0) 

The terminal always responds: 

3,1,0,0,1,0,0,1,1,1,1,2,0,0,0,0,<terminator> 
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Read Graphics Text Status (Parameter=7) 

The terminal returns the current text size, orientation, slant, and type of 
justification. Refer to Graphics Text in this section for a description of 
graphics text characteristics. 

Read Graphics Text Request: Ec # s7 A 

The terminal returns: <X size>,<Y 5 i z e > , 

<origin>, <angle> , <slantxterminator> 

where: <Xsize> = X dimension of the character cell (sign plus 5 

digits) 

<Y size> = Y dimension of the character cell (sign plus 5 
digits) 

<origin> = Relative position of text to cursor (see text 
origin command)(l digit) 

<ang 1 e> = Text angle 0, 90, 180, or 270 (5 digits and a 
decimal point) 

<slant> = 00000. or 00027. degrees 
Sample terminal response: 

+00007,+00010,1,00090.,00027.CR 

Read Zoom Parameter (Parameter=8) 

This request returns the zoom setting. Since the terminal does not have 
the zoom feature, it always returns constant values. 

Read Zoom Status Request: Ec * s 8 A 

The terminal responds: 

<zoom 5ize>,<zoom on/offxterminator> 

where: <zoom size) = 001. 

<zoom on/of f> =0 for Off 

This response is always: 0 0 1 . , 0 C R 
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Read Relocatable Origin (Parameter=9) 

The position of the relocatable origin is returned as X and Y coordinates. 

Read Relocatable Origin Request: Ec * s 9 A 

The terminal responds: <X coordinate) , <Y coordinate> 

< terminator > 

With the origin set to the lower left corner of the screen, the terminal 
responds: 

+00000,+00000CR 

Read Reset Status (Parameter = 10) 

You can determine whether or not the terminal has executed a full reset 
(or Power On) since the last time reset status was checked. This tells 
whether or not you need to reestablish terminal settings or images 
before resuming terminal functions. An additional seven bytes are 
returned but are not used. 

Read Reset Status Request: Ec * 5 1 0 A 

The terminal responds: 

<reset> , <b1 > , <b2> , <b3> , <b4> , <b5> , <b6> ,<b7xterminator> 

where: <reset> =0No full reset since last check 

or 

1 Terminal has been reset 
<b 1 >- <b7> = 0 (not used) 


Read Area Shading Capability (Parameter = 11) 

The area shading capability of the terminal can be read. These are fixed 
for the terminal. 

Read Area Shading Request: E c * s 11 A 

The terminal always responds: 2,8,8<terminator> 

The "2" indicates that the area shading can be a polygon. The first "8" 
indicates that the shading pattern is 8 units wide. The second "8" 
indicates that the shading pattern is 8 units high. 
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Read Graphics Modification Capabilities 
(Parameter=12) 

You can read the terminal's dynamic graphics capabilities. This is the 
ability of the terminal to change selected portions of the display. These 
are fixed for the terminal. 

Read Graphics Modification Request: Ec * 5 12 A 
The terminal always responds: 1,1 <terminator> 

These two bytes indicate that the terminal has selective erase and 
complement capabilities. 

Any Other Parameter 

Any other parameter that has not been assigned causes the terminal ID 
to be returned. This is to prevent an invalid status request from tying up 
the requesting computer while waiting for a response. 

The terminal responds: 2623A <terminator> 

or 

150A <terminator> 

The following BASIC program can be used to read all HP 150 status 
values: 

10 REM *****.********...*. 

20 REM * THIS PROGRAM ILLUSTRATES READING ALL HP150 STATUS VALUES * 

30 REM.*****. 

40 REM .STATUS VALUES FROM 1 TO 12 WILL BE READ 

50 PRINT " A KEYBOARD RESPONSE IS REQUIRED AFTER THE THIRD RESPONSE " 

60 FOR 1-1 TO 12 

70 PRINT CHR$C27) I ; ,,A ";CHRC 17) 'COMMAND TO READ STATUS 

80 LINE INPUT A$ 'READ RESPONSE 

90 PRINT "STATUS OF PARAMETER ";I;" IS "A$ 'DISPLAY RESPONSE 
100 NEXT I 
110 STOP 
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GRAPHICS CONTROL ESCAPE 
SEQUENCES 

Graphics Display Control 

The following escape sequence controls the graphics display. 

E c * d < z > Performs the indicated action < z > on the graphics 

display. 


z 

ACTION 

a 

Clear graphics memory 

b 

Set graphics memory 

c 

Turn on graphics display 

d 

Turn off graphics display 

e 

Turn on alphanumeric display 

f 

Turn off alphanumeric display 

k 

Turn on graphics cursor 

1 

Turn off graphics cursor 

m 

Turn on rubber band line 

n 

Turn off rubber band line 

<x>, <y> o 

Move graphics cursor to horizontal 
position < x > and vertical position < y > 
(relative to the origin) 

<x>, <y> p 

Move graphics cursor to horizontal 
position < x > and vertical position < y > 
(relative to its present location) 

q 

Turn oi} alphanumeric cursor 

r 

Turn off alphanumeric cursor 

s 

Turn on graphic text mode 

t 

Turn off graphics text mode 

z 

No operation 
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Graphics Label Transmission 

This escape sequence is used for transmission of a graphics text label 
from a program to the terminal. 

Ec *1 < text > The characters contained in <text> are printed 

CR, CR LF , on the display starting at the pen position. 

LF CR, or LF 


Vector Drawing 

The following escape sequences are used to draw vectors. 
Ec *m <x>a Selects drawing mode <x>. 


X 

MODE 



0 

No effect 



1 

Clear 



2 

Set 



3 

Complement 



4 

Jam 



Selects line type < x >. 



X 

LINE TYPE 

X 

LINE TYPE 

1 

Solid line 

7 

Line #4 

2 

User line pattern 

8 

Line #5 

3 

Current area 
pattern 

9 

Line #6 

4 

line #1 

10 

Line #7 

5 

line #2 

11 

Point plot 

6 

line #3 
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Ec *m <x> 

<y> c 

Defines an eight-bit segment of line pattern and a 
scale; where: 

< x > is a number from 0 to 255 which, when 
converted to its binary form, illustrates the segment 
of line pattern. 

<y> is a number from 0 to 255 which indicates the 
number of times the line pattern should be 
repeated. 

Ec # m <a> <b> 

<c > <d> <e> 

<f> <g h>d 

Defines an 8 X 8 pattern where < a > through < h > 
are numbers from 0 through 255 which, when 
converted to their binary values and 
stacked, illustrate the pattern. 

Ec # m <x 1 > , 
<y1>, <x2>, 

<y2, >e 

Defines a rectangular area to be filled, where 
<x1 > , <y 1 > and <x2> , <y2> define the rectangle 
located with respect to the absolute origin. 

Ec *m <x1 > , 
<y1>, <x2>, 

<y2 > f 

Defines a rectangular area to be filled, where 
<x1 > , <y 1 > and <x2> , <y2> define the rectangle 
with respect to the relocatable origin. 

Ec # m <x>, 

<y>j 

Locates the relocatable origin at 

coordinates < x > , < y > with respect to the absolute 

origin. 
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Ec *m <x> g 


Ec # m <x>h 


Ec *m k 


Ec *m 1 


Ec *m <x>m 


Selects area pattern "x": 

x AREA PATTERN 

1 Solid area fill. 

2 User-defined area fill (default). 

3 Predefined pattern 0 (short dashed 
hatching). 

4 Predefined pattern 1 (long dashed 
hatching). 

5 Predefined pattern 2 (hatching). 

6 Predefined pattern 3 (cross hatching). 

7 Predefined pattern 4 (fine cross 
hatching). 

8 Predefined pattern 5 (medium 
checkerboard.) 

9 Predefined pattern 6 (fine checkerboard, 
1:1 blend). 

10 Predefined pattern 7 (3:1 blend). 

Set area boundary pen < x >; where < x > is an integer 
in the range -32767 through 32767. The three low 
bits of the binary form of the integer is used to 
select the pen (0...7). 

Locates the relocatable origin at the current pen 
position. 

Locates the relocatable origin at the graphics cursor 
position. 

Sets the graphics text size to <x>, where <x> is a 
number from 1 to 8. 
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Ec # m < x >n Sets the graphics text orientation to < x >. 

x ROTATION (DEGREES) 

1 0 

2 90 

3 180 

4 270 


Ec *m o 

Turns on text slant. 

Ec # m p 

Turns off text slant. 

Ec *m <x>q 

Sets the origin of graphics text at location < x > on 


the display. 


X 

LOCATION 

X LOCATION 

0 

left/baseline 

5 center/middle 

1 

left/bottom 

6 center/top 

2 

left/middle 

7 right/bottom 

3 

left/top 

8 right/middle 

4 

center/bottom 

9 right/top 

Set graphics defaults: 



PARAMETER 

DEFAULT 

* 

Pen Condition 

Down 

* 

Line Type 

1 (solid) 

* 

Drawing Mode 

2 

* 

User Defined Line 

Pattern 

255,1 

* 

Area Fill Type 

2 (User Defined 
Pattern) 

* 

User Defined Area 

Fill Pattern 

255,255.(Solid) 
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PARAMETER 

DEFAULT 

* Boundary Pen 

Off 

* Graphics Text 

Off 

* Text Size 

1 

* Text Direction 

1 

* Text Origin 

1 (left, bottom) 

* Text Slant 

Off 

Relocatable Origin 

0,0 

Alpha Video 

On 

Graphics Video 

On 

Alpha Cursor 

On 

Graphics Cursor 

Off 

Graphics Cursor 
Address 

0,0 

Rubberband Line 

Off 

Compatibility Mode: 


Page Full Straps 

0 (Out) 

GIN Strap 

0 (CR Only) 


NOTE 

Parameters marked with an asterisk are those affected by the sequence 
Ec *m 1 r. 


Ec # m 1 r 

Sets the graphics defaults which are marked with 
an asterisk in the list above. 

Ec # m z 

No operation. 


D-71 





Plotting Commands 

This escape sequence is used in plotting vectors. 

E c * p < x > Performs action < x > 

x ACTION 

a Lift the pen 

b Lower the pen 

c Use graphics cursor position as new 

point 

d Draw a point at the current pen position 

and lift the pen 

e Set relocatable origin at the current pen 

position 

f Data is ASCII absolute 

g Data is ASCII incremental 

h Data is ASCII relocatable 

i Data is absolute 

j Data is short incremental 

k Data is incremental 

1 Data is relocatable 

s Start area fill 

t End area fill 

z No operation 
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Graphics Status 

This escape sequence reads the graphics status. 

Ec *5 <x> A Reads status type <x>. 

x STATUS 

1 Terminal I.D. 

2 Pen position 

3 Graphics cursor position 

4 Read cursor position and wait for key 

5 Display size 

6 Graphics capabilities 

7 Graphics text status 

8 Read zoom status 

9 Relocatable origin 

10 Reset status 

11 Area shading 

12 Dynamics 
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Compatibility Mode 

These escape sequences are used in Compatibility mode. 
Ec * t <x>a Selects graphics terminator. 

x TERMINATOR 

0 CR 

1 CR EOT 

2 None 

Ec * t < x > b Sets or clears Page Full Break strap. 

x ACTION 


Ec *t <x>c 


Ec *t <x>d 


Ec * t z 
Ec * w r 


0 Clear 

1 Set 

Sets or clears Page Full Busy strap, 
x ACTION 

0 Clear 

1 Set 

Sets or clears 4014 mode: 

X ACTION 

0 4010 mode 

1 4014 mode 

No operation. 

Graphics hard reset. 
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INDEX 


7- bit mode.. 

8- bit mode. 


A 


absolute addressing. 

absolute coordinate position 
absolute display coordinates 

absolute format. 

advance line. 

advance page. 

AGIOS. 

AGIOS calls.. 

AGIOS function calls.. 

AGIOS function code. 

AGIOS functions.. 

AGIOS touch functions. 

AGIOS video functions. 

AIOS. 

alphanumeric cursor. 

alphanumeric display memory.. 

alphanumeric display. 

alphanumeric memory. 

alphanumeric screen size. 

alternate character sets. 

application softkey label.... 

application softkeys. 

area fill pattern. 

area fills. 

area pattern. 

area shading capability. 

ASCII control characters. 

ASCII data transfer. 

ASCII fields. 

ASCII keys. 

ASCII space. 

auto line feed. 


B 


.2-31 

.5-64, 5-81 

.5-15 

.5-61 

.2-U7 

.2-47 

.2-21, 3-1 

.3-1, 3-3 

...1-3, A-l, B-l/B-2 

.4-1, B-3 

3-1, 4-33, B-10, C-l 
.B-l 


.C-l 

.3-2, 4-1 

.5-17/5-18 

.5-3 

.5-9/5-10 

.2-25 

.5-103 

.2-26 

.4-22, 4-24, 4-46 

2-4, 4-21, 4-49, 4-67 

.5-29 

.D-16/D-22 

.5-74 

.5-99 

.5-55 

.2-50 

.2-14, 2-18, 4-66 

.4-46 


5-55 

2-43 


BASIC compiler. 

batch function call. 

binary data transfer. 

block mode transfer. 

block mode. 

block transfers. 

block-mode transmissions, 
block-transfer-priorities 
boundary pen. 


.B-12 

.4-3 

.2-49 

.2-42 

.2-40, 4-48 

.2-40, 2-60 

.2-43 

.2-61 

5-36, 5-74/5-76, 5-84/5-88 


1-1 
















































Index 


boundary.5-35/5'36 

break key.6-11 


c 


cell size. 

character set. 

clear area. 

clear mode. 

C0M1. 

COM2. 

command completion-status... 
compatibility mode, Graphics 

complement mode. 

compress characters mode.... 

computer mode. 

control functions. 

cooked mode. 

copy a selected line. 

copy all. 

copy page. 

current cursor position. 

current pen position. 

cursor positioning. 

cursor types. 

cursor-position sensing. 

cursor-relative addressing.. 
cursor. 


.5-50 

...2-23, 4-6 

.4-12 

.5-22, D-12 

.6-1/6-2, 6-17 

.6-1/6-2, 6-17 

.2-59 

.D-U7/D-55 

.5-22/5-23, D-12 

.2-52 

.4-3**, 4-48, 6-10/6-11 

. 4-25 

.4-61/4-62, 6-17 

.2-48 

.2-48 

.2-48 

.5-16, 5-71, 5-91 

5-13,5-61,5-63/5-65,5-71/5-73,5-81/5-83 

.2-33 

.4-25 

.2-59 

.2-31 

.2-31 
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data comm control function... 

data comm function code. 

data comm functions. 

data comm programs. 

data comm transparency mode.. 

data communications. 

data logging mode. 

data operations. 

data transfer. 

data word. 

define area. 

defined area. 

destination device. 

device id. 

device status. 

device-status request. 

display. 

display control functions.... 

display enhancements. 

display memory. 

display screen. 

display structure. 

draw mode.*. 

drawing mode. 

dynamic graphics capabilities 


.6-3 
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.6-5, 6-15 
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.6-1 

.2-47 

.2-45 
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.2-31 

.2-31 

.2-30 
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enhace 

escape 

escape 

escape 


area. 

sequence processor. 

sequences. 

sequences - Graphic Control 
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4-13 

.1-2 


2-1, A-l 
....D-66 


F 


fast AGIOS entry.U-33 

fields.2-11 

form feed. 2-kj 

format mode.2-38 
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GIOS. 

GIOS function code. 

graphics attributes. 

graphics character, creating. 

graphics character set. 

graphics character set, re-defining. 

graphics compatibility mode. 

graphics control escape sequences. 

graphics control functions. 

graphics cursor. 

graphics cursor control. 

graphics default parameters. 

graphics display. 

graphics display control. 

graphics display memory. 

graphics drawing modes. 

graphics functions in display functions mode 

graphics hard copy operations. 

graphics memory. 

graphics pad mode. 

graphics parameters. 

graphics plotting. 

graphics plotting functions. 

graphics plotting sequences. 

graphics screen size. 

graphics settings. 

graphics status. 

graphics status functions. 

graphics text. 

graphics text functions. 

graphics text label. 

graphics text mode. 

graphics text orientation.. 

graphics text origin.. 

graphics text sequence.. 

graphics text size.. 

graphics vector drawing mode.. 


.3-2, 5-1/5-2 
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.5-95 

.5-49 

.5-Uo, 5-49, 5-57 

.5-53 

.D-U 7 /D -55 

.D-66 
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handshaking. 

high-level languages. 
HP Roman-8 extensions 
HPIB device. 
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2 - 60 , 6-2 

.B-l, C-l 

.5-55 

. 2-50 
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ignore. 

incremental coordinate position 

incremental format. 

intercept. 

internal printer. 


.4-60 

5-69, 5-79, 5-82 

.5-61 

.4-60 

. 2-52 
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jam mode 


5-23, D-12 
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key characteristics.4-46, 4-55, 4-57 

keyboard.2-20, 4-47 

keyboard device id.4-40 

keyboard device id. 4-63 

keyboard graphics functions.D-3 

keyboard intercept mode.4-21, 4-47 

keyboard intercept.4-59 

keyboard processing functions.4-46 

keyboard processing.4-40 

keycode.4-58 

keycode field.4-40 

keycode fields.2-l4, 4-66 

keycode mode.2-4,2-8,4-21,4-40,4-47,4-59/4-60,4-62/4-63,4-66,4-68 

keycode table.4-52 
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lift pen.5"63 

line feed.2-47 

line pattern and scale. 5~27 

line type.5"25 

lower pen.5~67 


M 


memory addressing.2-31 

memory lock.2-33 

metric format mode. 2-52 

mode function keys.2-34 

modem.6-10 

move mode. ..5~51 

MS-pascal compiler.. .B-5 

multiple-character escape sequences.... 2-1 

multiple-character escape sequence. .2-2 
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non-interceptable functions.4-54 

normal fields. 2 - 15 , 4-66 

normal.4-60 

numeric pad key, shifted.4-51 

numeric pad mode.4-50 
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offset table 


5-57 


P 


parameters, graphics default.D-2U 

picture definition parameters.5"101 

plotting sequences, graphics.D-25/D-29 

point plot. 5 - 26 , 5-72 

po inter table.5 ~ 53, 5 “ 56 

polygon boundary pen.5 "84 

polygon draw.5-81/5-83 

polygon move.5*77/5-80 

polygonal area fill.5“74 

polygonal area fill pattern.•••5"34 

Port 1.6-2, 6-19 

Port 2.6-2, 6-19 

primary terminal status.2-57, 2-62 
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qualifier word 


4-40, 4-54, 4-63, 4-66/4-67 
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Raw mode.4-21, 4-47, 4-59, 4-6l, 6-17 
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read data block. 6-15 

record mode.2-47 
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relocatable coordinate position. 5 " 65 , 5"70, 5"80, 5-83 

relocatable format.5-33,5-37/5-39,5-61,5-65,5-70,5-73,5-80,5-83,5-97 

relocatable origin.5-37/5*39, 5 _ 73, D-22/D-23 

remote/serial field.6-2 


report format mode.... 

reset status. 
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row/column reporting.. 
row/column reports.... 

rubber band line. 

rubber band line mode. 
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screen-relative addressing.2-31 

secondary terminal status.2-59» 2-67 

selective erase.5"23 

send data block.6-13 

serial ports. 6-1 

set mode.5-22/5-23 

shift area.U-l6 

shift bits field.4-64 

shift bits.4-63 

single graphics character.5"59 

softkey fields.4-4l 

softkey labels.U-U9 

softkey touch field.4-4l 

softkey touch sensitivity.2-17 

source device. 2-46 

special keys.4-46, 4-48, 4-57 

status, graphics.D-58 

status request.2-58, 2-60/2-61 

system keys.2-4 

system softkeys.4-21 
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terminal capabilities. 

terminal features. 

terminal ID status. 

terminal identification. 

terminal mode. 

terminal status. 

text slant. 

toggle fields. 

touch field. 

touchscreen. 

touchscreen functions. 

touchscreen reporting. 

transmit function key mode.... 
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.2-12, 2-14, 4-35 

_2-11, 4-38, 4-47, 4-66 
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user area fill pattern, 
user-definable softkeys 

user-defined keys. 
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5-29 

2-17 
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vector draw. 

vector drawing functions 

vector drawing mode. 

vector line type. 

vector list. 1 ... 

vector move. 

vectors. 

vectors, graphics. 
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5-25 
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